TreeView_GetItem makro (commctrl.h)

2024-10-24

Mengambil beberapa atau semua atribut item tampilan pohon. Anda dapat menggunakan makro ini atau mengirim pesan TVM_GETITEM secara eksplisit.

Sintaksis

BOOL TreeView_GetItem(
   HWND     hwnd,
   LPTVITEM pitem
);

Parameter

hwnd

Jenis: HWND

Tangani ke kontrol tampilan pohon.

pitem

Jenis: LPTVITEM

Arahkan ke struktur TVITEM yang menentukan informasi untuk mengambil dan menerima informasi tentang item. Dengan versi 4.71 dan yang lebih baru, Anda dapat menggunakan struktur TVITEMEX sebagai gantinya.

Mengembalikan nilai

Jenis: BOOL

Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya.

Komentar

Saat pesan TVM_GETITEM dikirim, hItem anggota TVITEM atau struktur TVITEMEX mengidentifikasi item untuk mengambil informasi, dan menutupi anggota menentukan atribut yang akan diambil.

Jika bendera TVIF_TEXT diatur dalam masker anggota TVITEM atau struktur TVITEMEX, anggota pszText harus menunjuk ke buffer yang valid dan anggota cchTextMax harus diatur ke jumlah karakter dalam buffer tersebut. Teks yang dikembalikan belum tentu akan disimpan di buffer asli yang diteruskan oleh aplikasi. Ada kemungkinan bahwa pszText akan menunjuk ke teks dalam buffer baru daripada menempatkannya di buffer lama.

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