Struktur TVITEMA (commctrl.h)

Artikel
08/22/2023

Menentukan atau menerima atribut item tampilan pohon. Struktur ini identik dengan struktur TV_ITEM , tetapi telah diganti namanya untuk mengikuti konvensi penamaan saat ini. Aplikasi baru harus menggunakan struktur ini.

Sintaks

typedef struct tagTVITEMA {
  UINT      mask;
  HTREEITEM hItem;
  UINT      state;
  UINT      stateMask;
  LPSTR     pszText;
  int       cchTextMax;
  int       iImage;
  int       iSelectedImage;
  int       cChildren;
  LPARAM    lParam;
} TVITEMA, *LPTVITEMA;

Anggota

mask

Jenis: UINT

Array bendera yang menunjukkan anggota struktur mana yang berisi data yang valid. Ketika struktur ini digunakan dengan pesan TVM_GETITEM , anggota masker menunjukkan atribut item untuk diambil. Jika digunakan dengan pesan TVM_SETITEM , masker menunjukkan atribut yang akan diatur. Anggota ini bisa menjadi satu atau beberapa nilai berikut:

Nilai	Makna
TVIF_CHILDREN	Anggota cChildren valid.
TVIF_DI_SETITEM	Kontrol tampilan pohon akan menyimpan informasi yang disediakan dan tidak akan memintanya lagi. Bendera ini hanya valid saat memproses pemberitahuan TVN_GETDISPINFO .
TVIF_HANDLE	Anggota hItem valid.
TVIF_IMAGE	Anggota iImage valid.
TVIF_PARAM	Anggota lParam valid.
TVIF_SELECTEDIMAGE	Anggota iSelectedImage valid.
TVIF_STATE	Anggota state dan stateMask valid.
TVIF_TEXT	Anggota pszText dan cchTextMax valid.

hItem

Jenis: HTREEITEM

Tangani ke item.

state

Jenis: UINT

Kumpulan bendera bit dan indeks daftar gambar yang menunjukkan status item. Saat mengatur status item, anggota stateMask menunjukkan bit yang valid dari anggota ini. Saat mengambil status item, anggota ini mengembalikan status saat ini untuk bit yang ditunjukkan dalam anggota stateMask .

Bit 0 hingga 7 dari anggota ini berisi bendera status item. Untuk daftar bendera status item yang mungkin, lihat Status Item Kontrol Tampilan Pohon.

Gambar overlay ditumpakan di atas gambar ikon item. Bit 8 hingga 11 anggota ini menentukan indeks gambar overlay berbasis satu. Jika bit ini nol, item tidak memiliki gambar overlay. Untuk mengisolasi bit ini, gunakan masker TVIS_OVERLAYMASK . Untuk mengatur indeks gambar overlay di anggota ini, gunakan makro INDEXTOOVERLAYMASK . Gambar overlay daftar gambar diatur dengan fungsi ImageList_SetOverlayImage .

Gambar status ditampilkan di samping ikon item untuk menunjukkan status yang ditentukan aplikasi. Tentukan daftar gambar status dengan mengirim pesan TVM_SETIMAGELIST . Untuk mengatur gambar status item, sertakan nilai TVIS_STATEIMAGEMASK dalam anggota stateMask struktur TVITEM . Bit 12 hingga 15 dari anggota status struktur menentukan indeks dalam daftar gambar status gambar yang akan digambar.

Untuk mengatur indeks gambar status, gunakan INDEXTOSTATEIMAGEMASK. Makro ini mengambil indeks dan mengatur bit 12 hingga 15 dengan tepat. Untuk menunjukkan bahwa item tidak memiliki gambar status, atur indeks ke nol. Konvensi ini berarti bahwa gambar nol dalam daftar gambar status tidak dapat digunakan sebagai gambar status. Untuk mengisolasi bit 12 hingga 15 anggota negara bagian, gunakan masker TVIS_STATEIMAGEMASK .

stateMask

Jenis: UINT

Bit anggota status yang valid. Jika Anda mengambil status item, atur bit anggota stateMask untuk menunjukkan bit yang akan dikembalikan dalam anggota status . Jika Anda mengatur status item, atur bit anggota stateMask untuk menunjukkan bit anggota status yang ingin Anda tetapkan. Untuk mengatur atau mengambil indeks gambar overlay item, atur bit TVIS_OVERLAYMASK . Untuk mengatur atau mengambil indeks gambar status item, atur bit TVIS_STATEIMAGEMASK .

pszText

Jenis: LPTSTR

Penunjuk ke string yang dihentikan null yang berisi teks item jika struktur menentukan atribut item. Jika anggota ini adalah nilai LPSTR_TEXTCALLBACK, jendela induk bertanggung jawab untuk menyimpan nama. Dalam hal ini, kontrol tampilan pohon mengirimkan kode pemberitahuan TVN_GETDISPINFO jendela induk saat memerlukan teks item untuk menampilkan, mengurutkan, atau mengedit dan kode pemberitahuan TVN_SETDISPINFO saat teks item berubah. Jika struktur menerima atribut item, anggota ini adalah alamat buffer yang menerima teks item. Perhatikan bahwa meskipun kontrol tampilan pohon memungkinkan string panjang disimpan sebagai teks item, hanya 260 karakter pertama yang ditampilkan.

cchTextMax

Jenis: int

Ukuran buffer yang ditujukkan oleh anggota pszText , dalam karakter. Jika struktur ini digunakan untuk mengatur atribut item, anggota ini diabaikan.

iImage

Jenis: int

Indeks dalam daftar gambar kontrol tampilan pohon dari gambar ikon yang akan digunakan saat item berada dalam status tidak dipilih. Jika anggota ini adalah nilai I_IMAGECALLBACK, jendela induk bertanggung jawab untuk menyimpan indeks. Dalam hal ini, kontrol tampilan pohon mengirimkan kode pemberitahuan TVN_GETDISPINFO induk untuk mengambil indeks saat perlu menampilkan gambar.

iSelectedImage

Jenis: int

Indeks dalam daftar gambar kontrol tampilan pohon dari gambar ikon yang akan digunakan saat item berada dalam status yang dipilih. Jika anggota ini adalah nilai I_IMAGECALLBACK, jendela induk bertanggung jawab untuk menyimpan indeks. Dalam hal ini, kontrol tampilan pohon mengirimkan kode pemberitahuan TVN_GETDISPINFO induk untuk mengambil indeks saat perlu menampilkan gambar.

cChildren

Jenis: int

Bendera yang menunjukkan apakah item memiliki item anak terkait. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
Nol	Item tidak memiliki item turunan.
Satu	Item memiliki satu atau beberapa item anak.
I_CHILDRENCALLBACK	Jendela induk melacak apakah item memiliki item turunan. Dalam hal ini, ketika kontrol tampilan pohon perlu menampilkan item, kontrol mengirimkan kode pemberitahuan TVN_GETDISPINFO induk untuk menentukan apakah item memiliki item turunan. Jika kontrol tampilan pohon memiliki gaya TVS_HASBUTTONS , kontrol ini menggunakan anggota ini untuk menentukan apakah akan menampilkan tombol yang menunjukkan keberadaan item anak. Anda dapat menggunakan anggota ini untuk memaksa kontrol menampilkan tombol meskipun item tidak memiliki item turunan yang disisipkan. Ini memungkinkan Anda untuk menampilkan tombol sambil meminimalkan penggunaan memori kontrol dengan menyisipkan item anak hanya ketika item terlihat atau diperluas.
I_CHILDRENAUTO	Versi 6.0Ditujukan untuk penggunaan internal; tidak disarankan untuk digunakan dalam aplikasi. Kontrol tampilan pohon secara otomatis menentukan apakah item memiliki item turunan. Catatan Bendera ini mungkin tidak didukung dalam versi Comctl32.dll mendatang. Selain itu, bendera ini tidak ditentukan dalam commctrl.h. Tambahkan definisi berikut ke file sumber aplikasi Anda untuk menggunakan bendera : `#define I_CHILDRENAUTO (-2)`

lParam

Jenis: LPARAM

Nilai yang akan dikaitkan dengan item.

Keterangan

Catatan

Header commctrl.h mendefinisikan TVITEM 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

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

Bagikan melalui

Struktur TVITEMA (commctrl.h)

Sintaks

Anggota

Keterangan

Persyaratan

Saran dan Komentar

Sumber Daya Tambahan: