Struktur TVINSERTSTRUCTA (commctrl.h)

  • Artikel

Berisi informasi yang digunakan untuk menambahkan item baru ke kontrol tampilan pohon. Struktur ini digunakan dengan pesan TVM_INSERTITEM . Strukturnya identik dengan struktur TV_INSERTSTRUCT , tetapi telah diganti namanya untuk mengikuti konvensi penamaan saat ini.

Sintaks

typedef struct tagTVINSERTSTRUCTA {
  HTREEITEM hParent;
  HTREEITEM hInsertAfter;
  union {
    TVITEMEXA itemex;
    TV_ITEMA  item;
  } DUMMYUNIONNAME;
} TVINSERTSTRUCTA, *LPTVINSERTSTRUCTA;

Anggota

hParent

Jenis: HTREEITEM

Menangani ke item induk. Jika anggota ini adalah nilai TVI_ROOT atau NULL, item disisipkan di akar kontrol tampilan pohon.

hInsertAfter

Jenis: HTREEITEM

Tangani ke item setelah item baru akan disisipkan, atau salah satu nilai berikut ini:

Nilai Makna
TVI_FIRST
 Sisipkan item di awal daftar.
TVI_LAST
 Sisipkan item di akhir daftar.
TVI_ROOT
 Tambahkan item sebagai item akar.
TVI_SORT
 Sisipkan item ke dalam daftar dalam urutan alfabet.

DUMMYUNIONNAME

DUMMYUNIONNAME.itemex

Jenis: TVITEMEX

Versi 4.71. Struktur TVITEMEX yang berisi informasi tentang item yang akan ditambahkan.

DUMMYUNIONNAME.item

Jenis: TVITEM

Struktur TVITEM yang berisi informasi tentang item yang akan ditambahkan.

Keterangan

Penyatuan dalam struktur ini telah diperbarui untuk bekerja dengan kompilator yang tidak mendukung serikat tanpa nama. Jika compiler Anda tidak mendukung union tanpa nama, tentukan token NONAMELESSUNION sebelum menyertakan file header commctrl.h.

Penting Menggunakan TVI_LAST untuk menyisipkan item ke dalam simpul tampilan pohon yang sudah berisi sejumlah besar item dapat memakan waktu lama, menyebabkan aplikasi berhenti merespons hingga operasi penyisipan selesai.
 

Catatan

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