Struktur COMBOBOXEXITEMA (commctrl.h)

  • Artikel

Berisi informasi tentang item dalam kontrol ComboBoxEx.

Sintaks

typedef struct tagCOMBOBOXEXITEMA {
  UINT    mask;
  INT_PTR iItem;
  LPSTR   pszText;
  int     cchTextMax;
  int     iImage;
  int     iSelectedImage;
  int     iOverlay;
  int     iIndent;
  LPARAM  lParam;
} COMBOBOXEXITEMA, *PCOMBOBOXEXITEMA;

Anggota

mask

Jenis: UINT

Sekumpulan bendera bit yang menentukan atribut struktur ini atau operasi yang menggunakan struktur ini. Bendera menentukan anggota yang valid atau harus diisi. Anggota ini bisa menjadi kombinasi dari nilai berikut.

Nilai Makna
CBEIF_DI_SETITEM
 Atur bendera ini saat memproses CBEN_GETDISPINFO; kontrol ComboBoxEx akan menyimpan informasi yang disediakan dan tidak akan memintanya lagi.
CBEIF_IMAGE
 Anggota iImage valid atau harus diisi.
CBEIF_INDENT
 Anggota iIndent valid atau harus diisi.
CBEIF_LPARAM
 Anggota lParam valid atau harus diisi.
CBEIF_OVERLAY
 Anggota iOverlay valid atau harus diisi.
CBEIF_SELECTEDIMAGE
 Anggota iSelectedImage valid atau harus diisi.
CBEIF_TEXT
 Anggota pszText valid atau harus diisi.

iItem

Jenis: INT_PTR

Indeks berbasis nol item.

pszText

Jenis: LPTSTR

Penunjuk ke buffer karakter yang berisi atau menerima teks item. Jika informasi teks sedang diambil, anggota ini harus diatur ke alamat buffer karakter yang akan menerima teks. Ukuran buffer ini juga harus ditunjukkan dalam cchTextMax. Jika anggota ini diatur ke LPSTR_TEXTCALLBACK, kontrol akan meminta informasi dengan menggunakan kode pemberitahuan CBEN_GETDISPINFO .

cchTextMax

Jenis: int

Panjang pszText, dalam TCHARs. Jika informasi teks sedang diatur, anggota ini diabaikan.

iImage

Jenis: int

Indeks berbasis nol gambar dalam daftar gambar. Gambar yang ditentukan akan ditampilkan untuk item ketika tidak dipilih. Jika anggota ini diatur ke I_IMAGECALLBACK, kontrol akan meminta informasi dengan menggunakan kode pemberitahuan CBEN_GETDISPINFO .

iSelectedImage

Jenis: int

Indeks berbasis nol gambar dalam daftar gambar. Gambar yang ditentukan akan ditampilkan untuk item ketika dipilih. Jika anggota ini diatur ke I_IMAGECALLBACK, kontrol akan meminta informasi dengan menggunakan kode pemberitahuan CBEN_GETDISPINFO .

iOverlay

Jenis: int

Indeks berbasis satu dari gambar overlay dalam daftar gambar. Jika anggota ini diatur ke I_IMAGECALLBACK, kontrol akan meminta informasi dengan menggunakan kode pemberitahuan CBEN_GETDISPINFO .

iIndent

Jenis: int

Jumlah spasi inden yang ditampilkan untuk item. Setiap indentasi sama dengan 10 piksel. Jika anggota ini diatur ke I_INDENTCALLBACK, kontrol akan meminta informasi dengan menggunakan kode pemberitahuan CBEN_GETDISPINFO .

lParam

Jenis: LPARAM

Nilai khusus untuk item.

Keterangan

Catatan

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