Bagikan melalui


Struktur NMTBDISPINFOW (commctrl.h)

Berisi dan menerima informasi tampilan untuk item bilah alat. Struktur ini digunakan dengan kode pemberitahuan TBN_GETDISPINFO.

Sintaksis

typedef struct {
  NMHDR     hdr;
  DWORD     dwMask;
  int       idCommand;
  DWORD_PTR lParam;
  int       iImage;
  LPWSTR    pszText;
  int       cchText;
} NMTBDISPINFOW, *LPNMTBDISPINFOW;

Anggota

hdr

Jenis: NMHDR

struktur NMHDR yang berisi informasi tambahan tentang pemberitahuan.

dwMask

Jenis: DWORD

Sekumpulan bendera yang menunjukkan anggota struktur ini mana yang diminta. Ini bisa berupa satu atau beberapa nilai berikut.

Nilai Arti
TBNF_IMAGE
Indeks gambar item sedang diminta. Indeks gambar harus ditempatkan di iImage anggota.
TBNF_TEXT
Saat ini tidak diimplementasikan.
TBNF_DI_SETITEM
Atur bendera ini saat memproses TBN_GETDISPINFO; kontrol toolbar akan menyimpan informasi yang disediakan dan tidak memintanya lagi.

idCommand

Jenis: int

Pengidentifikasi perintah item yang informasi tampilannya sedang diminta. Anggota ini diisi oleh kontrol sebelum mengirim kode pemberitahuan.

lParam

Jenis: DWORD_PTR

Nilai yang ditentukan aplikasi yang terkait dengan item yang informasi tampilannya sedang diminta. Anggota ini diisi oleh kontrol sebelum mengirim kode pemberitahuan.

iImage

Jenis: int

Indeks gambar untuk item.

pszText

Jenis: LPTSTR

Penunjuk ke buffer karakter yang menerima teks item.

cchText

Jenis: int

Ukuran pszText buffer, dalam karakter.

Komentar

Nota

Header commctrl.h mendefinisikan NMTBDISPINFO sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem 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

Syarat Nilai
klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Header commctrl.h