Header_GetItem makro (commctrl.h)

2024-10-24

Mendapatkan informasi tentang item dalam kontrol header. Anda dapat menggunakan makro ini atau mengirim pesan HDM_GETITEM secara eksplisit.

Sintaksis

BOOL Header_GetItem(
   HWND     hwndHD,
   int      i,
   LPHDITEM phdi
);

Parameter

hwndHD

Jenis: HWND

Handel ke kontrol header.

i

Jenis: int

Indeks item yang informasinya akan diambil.

phdi

Jenis: LPHDITEM

Penunjuk ke struktur HDITEM . Ketika pesan dikirim, mask anggota menunjukkan jenis informasi yang diminta. Saat pesan kembali, anggota lain menerima informasi yang diminta. Jika anggota mask menentukan nol, pesan mengembalikan TRUE tetapi tidak menyalin informasi ke struktur.

Mengembalikan nilai

Jenis: BOOL

Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya.

Komentar

Jika bendera HDI_TEXT diatur dalam masker anggota struktur HDITEM , kontrol dapat mengubah pszText anggota struktur untuk menunjuk ke teks baru alih-alih mengisi buffer dengan teks yang diminta. Aplikasi tidak boleh berasumsi bahwa teks akan selalu ditempatkan di buffer yang diminta.

Makro Header_GetItem didefinisikan sebagai berikut:

#define Header_GetItem(hwndHD, i, phdi)      \

    (BOOL)SendMessage((hwndHD), HDM_GETITEM,   \

    (WPARAM)(int)(i), (LPARAM)(LPHDITEM)(phdi))

Persyaratan

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

Bagikan melalui