DGGetItemTooltipString

DLGH 리소스로부터 주어진 다이얼로그 항목의 툴팁 텍스트를 읽습니다.

    Int32 DGGetItemTooltipString (
      short   dialId,
      short   item,
      char*   text
      Int32   size
    );

파라미터

dialId

다이얼로그 또는 탭 페이지의 ID입니다. DG_TOP_MODAL은 최상위 Modal 다이얼로그를 지정합니다.

 

item

다이얼로그 항목의 1-기반 인덱스입니다.

 

text

텍스트를 수신하는 버퍼에 대한 포인터입니다. 이 파라미터는 NULL이 될 수 있습니다.

 

size

text 버퍼의 크기입니다. 만약 text가 NULL이면, 이 파라미터는 무시합니다.

리턴 값

0 : DLGH 리소스를 찾지 못했습니다.
1...n : 텍스트의 길이입니다. (0 terminator 포함) 만약 text가 NULL이면, 요청된 버퍼의 길이입니다.

설명

(Palette, Modeless 또는 Modal 다이얼로그, 또는 탭 페이지 위에 있는) 모든 다이얼로그 항목은 2가지 타입의 도움말 정보를 가질 수 있습니다: 간략한 것과 별도의 도움말 엔진에 있는 자세한 정보에 대한 앵커가 있습니다.

Macintosh의 경우, Macintosh 시스템 Help 메뉴를 통해 이 기능을 활성화하였을 때 풍선 도움말에 간략한 것이 표시됩니다. Windows의 경우, 툴팁들이 간략한 항목 도움말을 보여주는 역할을 합니다. 항목 자세한 도움말 정보는 포커스 가능한 다이얼로그 항목에 키보드 포커스를 셋팅하고 Windows의 경우 [F1] 키, 또는 Macintosh의 경우 [Help] 키를 눌러서 호출할 수 있습니다. 아니면 항목 위에 오른쪽 마우스 버튼을 클릭하여 호출할 수도 있습니다. 그 외에도 다이얼로그 캡션의 도움말 [?] 버튼을 클릭한 다음 항목 자체를 클릭하여 호출할 수도 있습니다. 만약 툴팁들이 활성화되면, 간략한 도움말 정보가 평소대로 표시됩니다.

모든 타입의 다이얼로그에 대한 항목 툴팁들과 도움말 앵커들은 DLGH 리소스에서 정의합니다. (다이얼로그 도움말의 GRC 사양)

각 다이얼로그 항목은 서로 다른 도움말 인덱스를 가진 1개 이상의 도움말 문자열을 가질 수 있습니다. 이것은 동일한 다이얼로그 항목에 대하여 각 상황에 맞는 도움말 문자열들을 보여주게 해줍니다. 다이얼로그 항목의 도움말 인덱스를 변경하려면 DGSetItemHelpIndex를 사용하십시오. 다이얼로그가 생성되었을 때 각 항목의 도움말 인덱스는 1로 세트됩니다. 만약 도움말 인덱스를 DGSetItemHelpIndex로 변경하면, 해당 툴팁 텍스트를 리턴할 것입니다.

요구사항

버전: DG 2.1.0 또는 이후

헤더: DG.h

라이브러리 가져오기: DG.lib [WIN]

모듈: DGLib [MAC], DG.dll [WIN]

참고사항

DG 함수, 다이얼로그 도움말의 GRC 사양
DGDisableToolTips, DGEnableToolTips
DGSetItemHelpIndex
DGDisplayContextHelp, DGShowContextHelpWithAnchor, DGGetDynamicHelpStrings