TTTOOLINFOW 구조체(commctrl.h)

아티클
08/08/2024

TOOLINFO 구조체는 도구 설명 컨트롤의 도구에 대한 정보를 포함합니다.

구문

typedef struct tagTOOLINFOW {
  UINT      cbSize;
  UINT      uFlags;
  HWND      hwnd;
  UINT_PTR  uId;
  RECT      rect;
  HINSTANCE hinst;
  LPWSTR    lpszText;
  LPARAM    lParam;
  void      *lpReserved;
} TTTOOLINFOW, *PTOOLINFOW, *LPTTTOOLINFOW;

멤버

cbSize

형식: UINT

이 구조체의 크기(바이트)입니다. 이 멤버를 지정해야 합니다.

uFlags

형식: UINT

도구 설명 표시를 제어하는 플래그입니다. 이 멤버는 다음 값의 조합일 수 있습니다.

값	의미
TTF_ABSOLUTE	도구 설명 창을 TTM_TRACKPOSITION 제공된 동일한 좌표에 배치합니다. 이 플래그는 TTF_TRACK 플래그와 함께 사용해야 합니다.
TTF_CENTERTIP	uId 멤버가 지정한 도구 아래에 도구 설명 창을 가운데에 옵니다.
TTF_IDISHWND	uId 멤버가 도구의 창 핸들임을 나타냅니다. 이 플래그가 설정되지 않은 경우 uId 는 도구의 식별자입니다.
TTF_PARSELINKS	버전 6.0 이상. 도구 설명 텍스트의 링크를 구문 분석해야 했음을 나타냅니다. Comctl32.dll 버전 6은 재배포할 수 없지만 Windows 이상에 포함되어 있습니다. Comctl32.dll 버전 6을 사용하려면 매니페스트에 지정합니다. 매니페스트에 대한 자세한 내용은 시각적 스타일 사용을 참조하세요.
TTF_RTLREADING	도구 설명 텍스트가 부모 창의 텍스트와 반대 방향으로 표시됨을 나타냅니다.
TTF_SUBCLASS	도구 설명 컨트롤이 WM_MOUSEMOVE 같은 메시지를 가로채기 위해 도구 창을 서브클래스해야 했음을 나타냅니다. 이 플래그가 설정되지 않은 경우 TTM_RELAYEVENT 메시지를 사용하여 메시지를 도구 설명 컨트롤로 전달해야 합니다. 도구 설명 컨트롤에서 처리하는 메시지 목록은 TTM_RELAYEVENT.
TTF_TRACK	도구 설명 창이 해당하는 도구 옆에 배치하고 TTM_TRACKPOSITION 메시지에서 제공하는 좌표에 따라 창을 이동합니다. TTM_TRACKACTIVATE 메시지를 사용하여 이 유형의 도구를 활성화해야 합니다.
TTF_TRANSPARENT	도구 설명 컨트롤이 마우스 이벤트 메시지를 부모 창으로 전달하도록 합니다. 도구 설명 창의 범위 내에서 발생하는 마우스 이벤트로 제한됩니다.

hwnd

형식: HWND

도구가 포함된 창에 대한 핸들입니다. lpszText에 LPSTR_TEXTCALLBACK 값이 포함된 경우 이 멤버는 TTN_GETDISPINFO 알림 코드를 수신하는 창을 식별합니다.

uId

형식: UINT_PTR

도구의 애플리케이션 정의 식별자입니다. uFlags에 TTF_IDISHWND 플래그가 포함된 경우 uId는 도구에 대한 창 핸들을 지정해야 합니다.

rect

형식: RECT

도구의 경계 사각형 좌표입니다. 좌표는 hwnd로 식별된 창의 클라이언트 영역의 왼쪽 위 모서리를 기준으로 합니다. uFlags에 TTF_IDISHWND 플래그가 포함된 경우 이 멤버는 무시됩니다.

hinst

형식: HINSTANCE

도구의 문자열 리소스를 포함하는 instance 대한 핸들입니다. lpszText가 문자열 리소스의 식별자를 지정하는 경우 이 멤버가 사용됩니다.

lpszText

형식: LPTSTR

도구의 텍스트 또는 텍스트가 포함된 문자열 리소스의 식별자를 포함하는 버퍼에 대한 포인터입니다. 이 멤버는 값을 반환하는 데 사용되는 경우도 있습니다. 반환된 값을 검사해야 하는 경우 는 충분한 크기의 유효한 버퍼를 가리킵니다. 그렇지 않으면 NULL로 설정할 수 있습니다. lpszText가 LPSTR_TEXTCALLBACK 설정되면 컨트롤은 TTN_GETDISPINFO 알림 코드를 소유자 창으로 보내 텍스트를 검색합니다.

lParam

형식: LPARAM

버전 4.70 이상. 도구와 연결된 32비트 애플리케이션 정의 값입니다.

lpReserved

형식: void*

예약되어 있습니다. NULL로 설정해야 합니다.

설명

일반 창은 텍스트를 왼쪽에서 오른쪽(LTR)으로 표시합니다. 오른쪽에서 왼쪽으로 읽는(RTL) 히브리어 또는 아랍어와 같은 언어를 표시하도록 Windows를 미러링할 수 있습니다. 일반적으로 도구 설명 텍스트는 부모 창의 텍스트와 동일한 방향으로 표시됩니다. TTF_RTLREADING 설정되면 도구 설명 텍스트가 부모 창의 텍스트와 반대 방향으로 읽습니다.

참고

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

요구 사항

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

다음을 통해 공유

TTTOOLINFOW 구조체(commctrl.h)

구문

멤버

설명

요구 사항

피드백

추가 리소스