TabCtrl_GetItem makro (commctrl.h)

2024-10-24

Mengambil informasi tentang tab dalam kontrol tab. Anda dapat menggunakan makro ini atau mengirim pesan TCM_GETITEM secara eksplisit.

Sintaksis

BOOL TabCtrl_GetItem(
   HWND     hwnd,
   int      iItem,
   LPTCITEM pitem
);

Parameter

hwnd

Jenis: HWND

Tangani ke kontrol tab.

iItem

Jenis: int

Indeks tab.

pitem

Jenis: LPTCITEM

Penunjuk ke struktur TCITEM yang menentukan informasi untuk mengambil dan menerima informasi tentang tab. Saat pesan dikirim, mask anggota menentukan atribut mana yang akan dikembalikan. Jika anggota mask menentukan nilai TCIF_TEXT, anggota pszText harus berisi alamat buffer yang menerima teks item, dan anggota cchTextMax harus menentukan ukuran buffer.

Mengembalikan nilai

Jenis: BOOL

Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya.

Komentar

Jika bendera TCIF_TEXT diatur dalam masker anggota struktur TCITEM, kontrol dapat mengubah pszText anggota struktur untuk menunjuk ke teks baru alih-alih mengisi buffer dengan teks yang diminta. Kontrol dapat mengatur anggota pszText ke null untuk menunjukkan bahwa tidak ada teks yang terkait dengan item.

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