Struktur TBBUTTONINFOA (commctrl.h)

Berisi atau menerima informasi untuk tombol tertentu di bilah alat.

Sintaks

typedef struct {
  UINT      cbSize;
  DWORD     dwMask;
  int       idCommand;
  int       iImage;
  BYTE      fsState;
  BYTE      fsStyle;
  WORD      cx;
  DWORD_PTR lParam;
  LPSTR     pszText;
  int       cchText;
} TBBUTTONINFOA, *LPTBBUTTONINFOA;

Anggota

cbSize

Jenis: UINT

Ukuran struktur, dalam byte. Anggota ini harus diisi sebelum mengirim pesan terkait.

dwMask

Jenis: DWORD

Kumpulan bendera yang menunjukkan anggota mana yang berisi informasi yang valid. Anggota ini harus diisi sebelum mengirim pesan terkait. Ini bisa menjadi satu atau beberapa nilai berikut.

Nilai	Makna
TBIF_BYINDEX	Versi 5.80. WParam yang dikirim dengan pesan TB_GETBUTTONINFO atau TB_SETBUTTONINFO adalah indeks, bukan pengidentifikasi.
TBIF_COMMAND	Anggota idCommand berisi informasi yang valid atau sedang diminta.
TBIF_IMAGE	Anggota iImage berisi informasi yang valid atau sedang diminta.
TBIF_LPARAM	Anggota lParam berisi informasi yang valid atau sedang diminta.
TBIF_SIZE	Anggota cx berisi informasi yang valid atau sedang diminta.
TBIF_STATE	Anggota fsState berisi informasi yang valid atau sedang diminta.
TBIF_STYLE	Anggota fsStyle berisi informasi yang valid atau sedang diminta.
TBIF_TEXT	Anggota pszText berisi informasi yang valid atau sedang diminta.

idCommand

Jenis: int

Pengidentifikasi perintah tombol.

iImage

Jenis: int

Indeks gambar tombol. Atur anggota ini ke I_IMAGECALLBACK, dan toolbar akan mengirim kode pemberitahuan TBN_GETDISPINFO untuk mengambil indeks gambar saat diperlukan.

Versi 5.81. Atur anggota ini ke I_IMAGENONE untuk menunjukkan bahwa tombol tidak memiliki gambar. Tata letak tombol tidak akan menyertakan spasi untuk bitmap, hanya teks.

fsState

Jenis: BYTE

Bendera status tombol. Ini bisa menjadi satu atau beberapa nilai yang tercantum dalam Status Tombol Bilah Alat.

fsStyle

Jenis: BYTE

Bendera gaya tombol. Ini bisa berupa satu atau beberapa nilai yang tercantum dalam Kontrol Bilah Alat dan Gaya Tombol.

cx

Ketik: WORD

Lebar tombol, dalam piksel.

lParam

Jenis: DWORD_PTR

Nilai yang ditentukan aplikasi yang terkait dengan tombol .

pszText

Jenis: LPTSTR

Alamat buffer karakter yang berisi atau menerima teks tombol.

cchText

Jenis: int

Ukuran buffer di pszText. Jika informasi tombol sedang diatur, anggota ini diabaikan.

Keterangan

Catatan

Header commctrl.h mendefinisikan TBBUTTONINFO sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	commctrl.h