Struktur THUMBBUTTON (shobjidl_core.h)
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