NMTTDISPINFOA 구조체(commctrl.h)

  • 아티클

TTN_GETDISPINFO 알림 코드를 처리하는 데 사용되는 정보를 포함합니다. 이 구조체는 TOOLTIPTEXT 구조체를 대체합니다.

구문

typedef struct tagNMTTDISPINFOA {
  NMHDR     hdr;
  LPSTR     lpszText;
  char      szText[80];
  HINSTANCE hinst;
  UINT      uFlags;
  LPARAM    lParam;
} NMTTDISPINFOA, *LPNMTTDISPINFOA;

멤버

hdr

형식: NMHDR

알림에 대한 추가 정보를 포함하는 NMHDR 구조체입니다.

lpszText

형식: LPTSTR

도구 설명 텍스트로 표시될 null로 끝나는 문자열에 대한 포인터입니다. hinst가 instance 핸들을 지정하는 경우 이 멤버는 문자열 리소스의 식별자여야 합니다.

szText[80]

형식: TCHAR

도구 설명 텍스트를 수신하는 버퍼입니다. 애플리케이션은 문자열 주소 또는 문자열 리소스를 지정하는 대신 텍스트를 이 버퍼에 복사할 수 있습니다. 80TCHAR를 초과하는 도구 설명 텍스트는 이 문서의 설명 섹션에 있는 설명을 참조하세요.

hinst

형식: HINSTANCE

도구 설명 텍스트로 사용할 문자열 리소스가 포함된 instance 대한 핸들입니다. lpszText가 도구 설명 텍스트 문자열의 주소인 경우 이 멤버는 NULL이어야 합니다.

uFlags

형식: UINT

포함된 NMHDR 구조체의 idFrom 멤버를 해석하는 방법을 나타내는 플래그입니다.

값 의미
TTF_IDISHWND
 이 플래그가 설정된 경우 idFrom 은 도구의 핸들입니다. 그렇지 않으면 도구의 식별자입니다.
TTF_RTLREADING
 오른쪽에서 왼쪽으로 읽는(RTL) 히브리어 또는 아랍어와 같은 언어를 표시하도록 Windows를 미러링할 수 있습니다. 일반적으로 도구 설명 텍스트는 부모 창의 텍스트와 동일한 방향으로 읽습니다. 부모 창에서 반대 방향으로 도구 설명을 읽으려면 알림을 처리할 때 uFlags 멤버에 TTF_RTLREADING 플래그를 추가합니다.
TTF_DI_SETITEM

버전 4.70. 알림을 처리하는 동안 이 플래그를 uFlags 에 추가하는 경우 도구 설명 컨트롤은 제공된 정보를 유지하고 다시 요청하지 않습니다.

lParam

형식: LPARAM

버전 4.70. 도구와 연결된 애플리케이션 정의 데이터입니다.

설명

도구 설명에 사용된 텍스트 길이가 80TCHAR를 초과하는 경우 lpszText 배열을 고유한 프라이빗 버퍼로 가리킬 필요가 있습니다. 시스템은 컨트롤에 TTS_NOPREFIX 스타일이 없는 한 도구 설명 컨트롤에 전달된 모든 문자열에서 앰퍼샌드(&) 가속기 TCHAR를 자동으로 제거합니다.

참고

commctrl.h 헤더는 NMTTDISPINFO를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
머리글 commctrl.h