Struktur TVITEMEXA (commctrl.h)

  • Artikel

Menentukan atau menerima atribut item tampilan pohon. Struktur ini adalah peningkatan struktur TVITEM . Aplikasi baru harus menggunakan struktur ini jika sesuai.

Sintaks

typedef struct tagTVITEMEXA {
  UINT      mask;
  HTREEITEM hItem;
  UINT      state;
  UINT      stateMask;
  LPSTR     pszText;
  int       cchTextMax;
  int       iImage;
  int       iSelectedImage;
  int       cChildren;
  LPARAM    lParam;
  int       iIntegral;
  UINT      uStateEx;
  HWND      hwnd;
  int       iExpandedImage;
  int       iReserved;
} TVITEMEXA, *LPTVITEMEXA;

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_EXPANDEDIMAGE

Versi 6.00 dan Windows Vista. Anggota iExpandedImage valid.
TVIF_HANDLE
 Anggota hItem valid.
TVIF_IMAGE
 Anggota iImage valid.
TVIF_INTEGRAL
 Anggota iIntegral valid.
TVIF_PARAM
 Anggota lParam valid.
TVIF_SELECTEDIMAGE
 Anggota iSelectedImage valid.
TVIF_STATE
 Anggota state dan stateMask valid.
TVIF_STATEEX

Versi 6.00 dan Windows Vista. Anggota uStateEx 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 . Untuk informasi selengkapnya mengenai anggota ini, lihat bagian keterangan.

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

Bit 8 hingga 11 anggota ini menentukan indeks gambar overlay berbasis satu. Gambar overlay ditumpakan di atas gambar ikon item. 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 di 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 tersebut 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 yang akan datang. Selain itu, bendera ini tidak didefinisikan 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.

iIntegral

Jenis: int

Tinggi item, dalam kelipatan tinggi item standar (lihat TVM_SETITEMHEIGHT). Misalnya, mengatur anggota ini ke 2 akan memberikan item dua kali tinggi standar. Kontrol tampilan pohon tidak menggambar di area tambahan, yang muncul di bawah konten item, tetapi ruang ini dapat digunakan oleh aplikasi untuk menggambar saat menggunakan gambar kustom. Aplikasi yang tidak menggunakan gambar kustom harus mengatur nilai ini ke 1, karena jika tidak, perilaku tidak ditentukan.

uStateEx

Jenis: UINT

Internet Explorer 6 dan yang lebih baru. Satu atau beberapa (sebagai kombinasi bitwise) dari status yang diperluas berikut.

Nilai Makna
TVIS_EX_DISABLED
 Windows Vista dan yang lebih baru. Membuat kontrol yang digambar berwarna abu-abu, yang tidak dapat berinteraksi dengan pengguna.
TVIS_EX_FLAT
 Membuat item datar—item bersifat virtual dan tidak terlihat di pohon; sebaliknya, anak-anaknya mengambil tempatnya dalam hierarki pohon. Status ini hanya valid ketika menambahkan item ke kontrol tampilan pohon.
TVIS_EX_HWND
 Membuat HWND terpisah untuk item. Status ini hanya valid ketika menambahkan item ke kontrol tampilan pohon.

hwnd

Jenis: HWND

Internet Explorer 6 dan yang lebih baru. Tidak digunakan; harus NULL.

iExpandedImage

Jenis: int

Internet Explorer 6 dan yang lebih baru. Indeks gambar dalam daftar gambar kontrol untuk ditampilkan saat item dalam status diperluas.

iReserved

Jenis: int

Anggota yang dicadangkan. Jangan gunakan.

Keterangan

Catatan

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

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

Lihat juga

Menambahkan Item Tree-View