다이얼로그 도움말의 GRC 사양

다이얼로그들은 자신의 다이얼로그 항목들에 대한 문맥 인식 도움말을 제공합니다.

모든 타입의 다이얼로그들에 대한 도움말 GRC 사양

    'DLGH'  resID  DialogHelpAnchor {
      [index1]  "toolTip1"  ItemHelpAnchor1
        ...
      [indexi]  "toolTipj"  ItemHelpGroupk-ItemHelpGroupl-ItemAnchorj
        ...
      [indexk]  "toolTipn"  ItemHelpAnchorn
    }

여기서 indexi (1 <= i <= k)는 다이얼로그 항목의 1-기반 인덱스입니다; "toolTipj"와 ItemHelpAnchorj (1 <= j <= n)는 각각 항목의 툴팁과 도움말 앵커 문자열입니다. k는 n과 다를 수 있는데 이는 다이얼로그 항목이 다수의 툴팁과 도움말 앵커를 가질 수 있기 때문이라는 것을 참고하십시오. (DGSetItemHelpIndex를 보십시오) indexi 파라미터들은 선택사항입니다. GRC 컴파일러는 위부터 아래로 라인들을 처리하다가 만약 항목 인덱스가 없는 툴팁과 도움말 문자열을 찾게 되면, 예전 라인의 인덱스를 사용합니다. 만약 1번째 라인에 항목 인덱스가 없다면 1을 사용합니다. 항목 인덱스들은 역행해서는 안된다는 것을 참고하십시오.

모든 타입의 다이얼로그에 있는 다이얼로그 항목은 2가지 타입의 도움말 정보를 가질 수 있습니다: 간략한 것과 자세한 것. Macintosh의 경우, Macintosh 시스템 Help 메뉴를 통해 이 기능을 활성화하였을 때 풍선 도움말에 간략한 것이 표시됩니다. Windows의 경우, 일반 툴팁은 간략한 항목 도움말을 보여주는 역할을 합니다. 툴팁들은 활성화된 경우에만 표시됩니다. DG가 초기화되었을 때, 툴팁들은 자동으로 활성화됩니다. 툴팁들을 표시하는 것을 비활성화하려면 DGDisableToolTips를 사용하고 다시 활성화하려면 DGEnableToolTips를 사용하십시오.

항목 도움말의 자세한 버전은 포커스 가능한 다이얼로그 항목에 키보드 포커스를 셋팅하고 Windows의 경우 [F1] 키, 또는 Macintosh의 경우 [Help] 키를 눌러서 호출할 수 있습니다. 아니면 항목 위에 오른쪽 마우스 버튼을 클릭하여 호출할 수도 있습니다. 그 외에도 다이얼로그 캡션의 도움말 [?] 버튼을 클릭한 다음 항목 자체를 클릭하여 호출할 수도 있습니다. (이 마지막 대안은 Windows 플랫폼에서 Modal 다이얼로그에서만 사용할 수 있고, 다이얼로그가 도움말 리소스를 갖고 있어야 합니다) 툴팁과 도움말 앵커 문자열은 DLGH 리소스에 정의되어 있습니다. DLGH 리소스의 리소스 ID는 다이얼로그의 GDLG 리소스의 리소스 ID와 동일해야 합니다.

동적으로 생성된 도움말 내용 목적을 위한 도움말 GRC 사양

    'DHLP'  resID {
      "toolTip1"  ItemHelpAnchor1
        ...
      "toolTipj"  ItemHelpGroupk-ItemHelpGroupl-ItemAnchorj
        ...
      "toolTipn"  ItemHelpAnchorn
    }

만약 동적 도움말 정보를 제공하고 싶으면, DHLP 리소스에 툴팁 - 도움말 앵커 쌍들을 저장하는 것을 권장합니다. ItemContextHelpRequested 또는 ItemToolTipRequested 이벤트가 발생했을 때, 요구되는 정보를 DGGetDynamicHelpStrings 함수로 로드할 수 있습니다. DHLP의 포맷은 DLGH 포맷과 매우 비슷하지만, 거기에는 DialogItemAnchor와 인덱스가 없습니다.

요구사항

버전: DG 2.1.0.66 또는 이후

헤더: DG.h

참고사항

다이얼로그 항목 타입의 GRC 사양, 다이얼로그 타입의 GRC 사양, 이미지 타입의 GRC 사양
Modal 다이얼로그, Modeless 다이얼로그, Palette 다이얼로그, 탭 페이지
다이얼로그 항목 타입, DGSetItemHelpIndex, DGDisableToolTips, DGEnableToolTips
DGRegisterAdditionalHelpLocation, DGUnregisterAdditionalHelpLocation
DGDisplayContextHelp, DGShowContextHelpWithAnchor, DGGetDynamicHelpStrings