THUMBBUTTON 구조체(shobjidl_core.h)

ITaskbarList3 인터페이스의 메서드에서 창의 축소판 그림 표현에 포함된 도구 모음에 사용되는 단추를 정의하는 데 사용됩니다.

구문

typedef struct THUMBBUTTON {
  THUMBBUTTONMASK  dwMask;
  UINT             iId;
  UINT             iBitmap;
  HICON            hIcon;
  WCHAR            szTip[260];
  THUMBBUTTONFLAGS dwFlags;
} THUMBBUTTON, *LPTHUMBBUTTON;

멤버

dwMask

형식: THUMBBUTTONMASK

이 구조체의 유효한 데이터를 포함하는 멤버를 지정하는 THUMBBUTTONMASK 값의 조합입니다. 항상 필요한 iId를 제외하고 다른 멤버는 무시됩니다.

iId

형식: UINT

도구 모음 내에서 고유한 단추의 애플리케이션 정의 식별자입니다.

iBitmap

형식: UINT

ITaskbarList3::ThumbBarSetImageList를 통해 설정된 이미지 목록 내 단추 이미지의 인덱스(0부터 시작)입니다.

hIcon

형식: HICON

단추 이미지로 사용할 아이콘의 핸들입니다.

szTip[260]

형식: WCHAR[260]

마우스 포인터가 단추를 가리키면 표시되는 단추 도구 설명의 텍스트가 들어 있는 와이드 문자 배열입니다.

dwFlags

형식: THUMBBUTTONFLAGS

단추의 특정 상태 및 동작을 제어하는 THUMBBUTTONFLAGS 값의 조합입니다.

설명

단추를 클릭하면 단추 ID가 포함된 WM_COMMAND 메시지가 연결된 애플리케이션 창으로 전송됩니다. 애플리케이션은 단추에 할당된 모든 작업을 처리합니다.

단추 이미지

hIcon 멤버를 통해 지정된 아이콘을 사용하는 경우 작업 표시줄은 아이콘의 자체 복사본을 만듭니다. 더 이상 필요하지 않을 때 hIcon 에 전달된 핸들을 해제하는 것은 호출자의 책임입니다.

단추 이미지에 대해 아이콘과 이미지 목록을 모두 지정하면 가능한 경우 아이콘이 사용됩니다. 어떤 이유로든 아이콘 검색 시도가 실패하면 이미지 목록의 이미지가 사용됩니다.

애플리케이션은 다음 단추 이미지를 제공해야 합니다.

• 기본 활성 상태의 단추입니다.
• 높은 dpi(인치당 점) 디스플레이에 사용하기에 적합한 이미지입니다.

이미지는 GetSystemMetrics(SM_CXICON) x GetSystemMetrics(SM_CYICON)의 32비트 및 차원이어야 합니다. 도구 모음 자체는 단추의 클릭, 사용 안 함 및 가리키기 상태에 대한 시각적 개체를 제공합니다.

요구 사항

지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
머리글	shobjidl_core.h(Shobjidl.h 포함)

추가 정보

ITaskbarList3::ThumbBarAddButtons

ITaskbarList3::ThumbBarUpdateButtons

작업 표시줄 확장

작업 표시줄 축소판 그림 도구 모음 샘플