DGItemHelpMsgData

만약 다이얼로그 콜백 함수가 다이얼로그 항목에 대하여 DG_MSG_ITEMHELP 메시지를 받으면, msgData 파라미터는 도움말 이벤트에 대한 정보를 포함하는 DGItemHelpMsgData structure에 대한 포인터입니다.

    struct DGItemHelpMsgData {
      short  subMessage;
      short  itemId;
      Int32  treeItem;
      short  listItem;
      char*  toolTipText;
      char*  contextHelpAnchor;
    };

멤버

subMessage

다음 값들 중 하나가 될 수 있습니다:

subMessage	의미
DG_HSM_TOOLTIP	툴팁 텍스트가 표시될 것입니다.
DG_HSM_CONTEXTHELP	지정한 도움말 앵커에 따라 컨텍스트 인식 도움말이 표시될 것입니다.

 

itemId

위에 메시지가 표시되는 다이얼로그 항목의 1-기반 인덱스입니다.

 

treeItem

만약 다이얼로그 항목이 트리 뷰이면, 요청 받은 도움말이 위에 나오는 트리 뷰 항목입니다. 그 외에는 0입니다.

 

listItem

만약 리스트 뷰 또는 리스트 박스 항목 타입 위에 도움말이 요청 받으면, DG는 요청 받은 도움말 위에 리스트 항목의 1-기반 인덱스를 둡니다.

 

toolTipText

만약 subMessage가 DG_HSM_TOOLTIP이면, 애플리케이션은 표시할 메시지를 포함하는 텍스트 포인터로 이 필드를 채울 수 있습니다. 이 포인터는 BMAllocatePtr로 할당해야 합니다. 해당 툴팁 및 도움말 앵커 pair를 DHLP 리소스로 저장하는 것을 권장합니다. 당신은 도움말 앵커를 DGGetDynamicHelpStrings 함수로 로드할 수 있습니다. 메시지가 표시된 후에, DG는 BMKillPtr 함수를 호출하여 할당한 메모리를 해제합니다. 만약 toolTipText이 NULL로 세트되면, DG는 GRC 리소스로부터 툴팁 텍스트를 가져오려고 시도합니다. Windows 플랫폼에서는 툴팁 텍스트가 8192 문자 길이를 가질 수 있습니다. Windows에서는 여러 개의 툴팁들을 "\n"으로 지정할 수 있습니다. 그러나 "\t" 문자들은 공백들로 대체됩니다.

 

contextHelpAnchor

만약 subMessage가 DG_HSM_CONTEXTHELP이면, 애플리케이션은 이 필드를 텍스트 포인터로 채웁니다. 이 텍스트 포인터는 (DGRegisterAdditionalHelpLocation 또는 스탠드얼론 애플리케이션의 경우 DG::Application::RegisterHelpLocation)으로 등록된 도움말 엔진에게 전달되는 파라미터가 되는 도움말 엥커를 포함하고 있습니다. 이 포인터는 BMAllocatePtr로 할당해야 합니다. 해당 툴팁 및 도움말 앵커 pair를 DHLP 리소스로 저장하는 것을 권장합니다. 당신은 도움말 앵커를 DGGetDynamicHelpStrings 함수로 로드할 수 있습니다. 도움말 엔진이 도움말 엥커 파라미터와 함께 실행된 후에, DG는 BMKillPtr 함수를 호출하여 할당한 메모리를 해제합니다. 만약 contextHelpText가 NULL로 세트되면, DG는 GRC 리소스로부터 컨텍스트 도움말 텍스트를 가져오려고 시도합니다.

요구사항

버전: DG 2.0.0 또는 이후

헤더: DG.h

참고사항

DG Structure, 콜백 함수, DG_MSG_ITEMHELP DGDisplayContextHelp, DGGetDynamicHelpStrings, DGShowContextHelpWithAnchor
DGDisableToolTips, DGEnableToolTips
다이얼로그 도움말의 GRC 사양
DGRegisterAdditionalHelpLocation, DGUnregisterAdditionalHelpLocation