Struktur THUMBBUTTON (shobjidl_core.h)

Artikel
08/26/2023

Digunakan oleh metode antarmuka ITaskbarList3 untuk menentukan tombol yang digunakan dalam toolbar yang disematkan dalam representasi gambar mini jendela.

Sintaks

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

Anggota

dwMask

Jenis: THUMBBUTTONMASK

Kombinasi nilai THUMBBUTTONMASK yang menentukan anggota struktur ini mana yang berisi data yang valid; anggota lain diabaikan, dengan pengecualian iId, yang selalu diperlukan.

iId

Jenis: UINT

Pengidentifikasi tombol yang ditentukan aplikasi, unik di dalam toolbar.

iBitmap

Jenis: UINT

Indeks berbasis nol dari gambar tombol dalam daftar gambar yang diatur melalui ITaskbarList3::ThumbBarSetImageList.

hIcon

Jenis: HICON

Handel ikon yang akan digunakan sebagai gambar tombol.

szTip[260]

Jenis: WCHAR[260]

Array karakter lebar yang berisi teks tipsalat tombol, ditampilkan saat penunjuk mouse mengarah ke tombol.

dwFlags

Jenis: THUMBBUTTONFLAGS

Kombinasi nilai THUMBBUTTONFLAGS yang mengontrol status dan perilaku tombol tertentu.

Keterangan

Saat tombol diklik, pesan WM_COMMAND yang berisi ID tombol dikirim ke jendela aplikasi terkait. Aplikasi menangani tindakan apa pun yang telah ditetapkan ke tombol .

Gambar Tombol

Saat menggunakan ikon, yang ditentukan melalui anggota hIcon , taskbar membuat salinan ikonnya sendiri. Adalah tanggung jawab pemanggil untuk membebaskan handel yang diteruskannya di hIcon ketika tidak lagi diperlukan.

Jika ikon dan daftar gambar ditentukan untuk gambar tombol, ikon akan digunakan jika memungkinkan. Jika karena alasan tertentu upaya untuk mengambil ikon gagal, gambar dari daftar gambar digunakan.

Aplikasi harus menyediakan gambar tombol ini:

Tombol dalam status aktif defaultnya.
Gambar yang cocok untuk digunakan dengan tampilan dpi tinggi (titik per inci).

Gambar harus 32-bit dan dimensi GetSystemMetrics(SM_CXICON) x GetSystemMetrics(SM_CYICON). Toolbar itu sendiri menyediakan visual untuk status tombol yang diklik, dinonaktifkan, dan diarahkan.

Persyaratan


Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Header	shobjidl_core.h (termasuk Shobjidl.h)

Lihat juga

ITaskbarList3::ThumbBarAddButtons

ITaskbarList3::ThumbBarUpdateButtons

Ekstensi Taskbar

Sampel Bilah Alat Gambar Mini Taskbar

Bagikan melalui