DGDisplayContextHelp
이 함수를 이용하여 DG에게 컨텍스트 인식 도움말 정보를 보여주도록 강요할 수 있습니다.
bool DGDisplayContextHelp ( void );
리턴 값
-
값 의미 true DG는 컨텍스트 인식 도움말 앵커를 찾고 등록된 도움말 엔진을 실행할 수 있습니다. false DG는 컨텍스트 인식 도움말을 찾을 수 없습니다. 또는 포커스된 다이얼로그가 등록된 도움말 엔진을 갖고 있지 않습니다. 또는 그 외 문제가 발생했습니다. 이러한 문제들로 인해 아무런 액션을 취하지 않습니다.
설명
이 함수는 다음과 같은 방식으로 작동합니다. 먼저, 포커스된 다이얼로그가 무엇인지 결정합니다. 만약 포커스된 다이얼로그가 없다면, 1번째로 보이는 Modeless 다이얼로그를 찾아봅니다. 만약 DG가 이러한 식으로 어떤 다이얼로그도 찾지 못한다면 아무 액션도 취하지 않고 false를 리턴합니다. 만약 아무 다이얼로그라도 찾게 된다면, DG는 다이얼로그 데이터로부터 생성자의 MDID를 가져옵니다. MDID로부터 등록된 도움말 엔진 경로를 결정할 수 있습니다. 만약 해당 MDID에 대하여 등록된 도움말 엔진이 없다면, 아무 액션도 취하지 않고 false를 리턴합니다. 만약 다이얼로그 항목이 포커스되어 있지 않다면, 도움말 엔진은 오직 다이얼로그 도움말 앵커와 함께 실행됩니다. 만약 다이얼로그 상에 포커스된 항목이 있다면, 도움말 엔진은 결합된 다이얼로그와 항목 도움말 앵커 파라미터와 함께 실행됩니다. 두 경우에는 함수가 true를 리턴합니다.
(Palette, Modeless 또는 Modal 다이얼로그, 또는 탭 페이지 위에 있는) 모든 다이얼로그 항목은 2가지 타입의 도움말 정보를 가질 수 있습니다: 간략한 것과 별도의 도움말 엔진에 있는 자세한 정보에 대한 앵커가 있습니다.
모든 타입의 다이얼로그에 대한 항목 툴팁들과 도움말 앵커들은 DLGH 리소스에서 정의합니다. (다이얼로그 도움말의 GRC 사양)
Macintosh의 경우, Macintosh 시스템 Help 메뉴를 통해 이 기능을 활성화하였을 때 풍선 도움말에 간략한 것이 표시됩니다. Windows의 경우, 툴팁들이 간략한 항목 도움말을 보여주는 역할을 합니다. 항목의 자세한 도움말 정보는 포커스 가능한 다이얼로그 항목에 키보드 포커스를 셋팅하고 Windows의 경우 [F1] 키, 또는 Macintosh의 경우 [Help] 키를 눌러서 호출할 수 있습니다. 아니면 항목 위에 오른쪽 마우스 버튼을 클릭하여 호출할 수도 있습니다. 그 외에도 다이얼로그 캡션의 도움말 [?] 버튼을 클릭한 다음 항목 자체를 클릭하여 호출할 수도 있습니다. 만약 툴팁들이 활성화되면, 간략한 도움말 정보가 평소대로 표시됩니다.
요구사항
- 버전: DG 2.1.0.66 또는 이후
- 헤더: DG.h
- 라이브러리 가져오기: DG.lib [WIN]
- 모듈: DGLib [MAC], DG.dll [WIN]
참고사항
DG 함수, 다이얼로그 도움말의 GRC 사양
DGDisableToolTips, DGEnableToolTips
DGRegisterAdditionalHelpLocation, DGUnregisterAdditionalHelpLocation
DGGetDynamicHelpStrings, DGShowContextHelpWithAnchor