Struktur HDITEMW (commctrl.h)
Berisi informasi tentang item dalam kontrol header. Struktur ini menggantikan struktur HD_ITEM.
Sintaksis
typedef struct _HD_ITEMW {
UINT mask;
int cxy;
LPWSTR pszText;
HBITMAP hbm;
int cchTextMax;
int fmt;
LPARAM lParam;
int iImage;
int iOrder;
UINT type;
void *pvFilter;
UINT state;
} HDITEMW, *LPHDITEMW;
Anggota
mask
Jenis: UINT
Bendera yang menunjukkan anggota struktur lain mana yang berisi data yang valid atau harus diisi. Anggota ini bisa menjadi kombinasi dari nilai berikut:
| Nilai | Arti |
|---|---|
|
Anggota |
|
Saat menangani pesan HDM_GETITEM, kontrol header mungkin tidak memiliki semua nilai yang diperlukan untuk menyelesaikan permintaan. Dalam hal ini, kontrol harus memanggil kembali aplikasi untuk nilai melalui pemberitahuan HDN_GETDISPINFO. Jika HDI_DI_SETITEM telah diteruskan dalam pesan HDM_GETITEM, kontrol akan menyimpan cache nilai apa pun yang dikembalikan dari HDN_GETDISPINFO (jika tidak, nilai tetap tidak diatur.) |
|
Anggota |
|
Jenis dan pvFilter anggota valid. Ini digunakan untuk memfilter nilai yang ditentukan dalam jenis anggota |
|
Sama seperti HDI_WIDTH. |
|
Anggota iImage valid dan menentukan gambar yang akan ditampilkan dengan item. |
|
Anggota lParam valid. |
|
Anggota iOrder valid dan menentukan nilai pesanan item. |
|
Versi 6.00 dan yang lebih baru. Anggota status |
|
|
|
Anggota |
cxy
Jenis: int
Lebar atau tinggi item.
pszText
Jenis:
Penunjuk ke string item. Jika teks diambil dari kontrol, anggota ini harus diinisialisasi untuk menunjuk ke buffer karakter. Jika anggota ini diatur ke LPSTR_TEXTCALLBACK, kontrol akan meminta informasi teks untuk item ini dengan mengirim kode pemberitahuan HDN_GETDISPINFO. Perhatikan bahwa meskipun kontrol header memungkinkan string dengan panjang apa pun disimpan sebagai teks item, hanya 260 TCHAR pertama yang ditampilkan.
hbm
Jenis:
Handel ke bitmap item.
cchTextMax
Jenis: int
Panjang string item, dalam TCHARs. Jika teks diambil dari kontrol, anggota ini harus berisi jumlah
fmt
Jenis: int
Bendera yang menentukan format item.
| Nilai | Arti |
|---|---|
|
Atur salah satu bendera berikut untuk menentukan pembenaran teks: |
|
Isi item dipusatkan. |
|
Konten item diratakan kiri. |
|
Konten item diratakan kanan. |
|
Atur salah satu bendera berikut untuk mengontrol tampilan: |
|
Item menampilkan bitmap. |
|
Bitmap muncul di sebelah kanan teks. |
|
Pemilik kontrol header menggambar item. |
|
Item menampilkan string. |
|
Nilai sebelumnya dapat dikombinasikan dengan: |
|
Menampilkan gambar dari daftar gambar. Tentukan daftar gambar dengan mengirim pesan HDM_SETIMAGELIST. Tentukan indeks gambar di iImage anggota struktur ini. |
|
Isolasi bit yang sesuai dengan tiga bendera justifikasi yang tercantum dalam tabel sebelumnya. |
|
Biasanya, jendela menampilkan teks kiri-ke-kanan (LTR). Windows dapat dicerminkan untuk menampilkan bahasa seperti Ibrani atau Arab yang membaca kanan-ke-kiri (RTL). Biasanya, teks header dibaca dalam arah yang sama dengan teks di jendela induknya. Jika HDF_RTLREADING diatur, teks header akan membaca ke arah yang berlawanan dari teks di jendela induk. |
|
Versi 6.00 dan yang lebih baru. Gambar panah bawah pada item ini. Ini biasanya digunakan untuk menunjukkan bahwa informasi di jendela saat ini diurutkan pada kolom ini dalam urutan turun. Bendera ini tidak dapat dikombinasikan dengan HDF_IMAGE atau HDF_BITMAP. |
|
Versi 6.00 dan yang lebih baru. Gambar panah atas pada item ini. Ini biasanya digunakan untuk menunjukkan bahwa informasi di jendela saat ini diurutkan pada kolom ini dalam urutan naik. Bendera ini tidak dapat dikombinasikan dengan HDF_IMAGE atau HDF_BITMAP. |
|
Versi 6.00 dan yang lebih baru. Item menampilkan kotak centang. Bendera hanya valid ketika gaya HDS_CHECKBOXES pertama kali diatur pada kontrol header. |
|
Versi 6.00 dan yang lebih baru. Item menampilkan kotak centang yang dicentang. Bendera hanya valid saat HDF_CHECKBOX juga diatur. |
|
Versi 6.00 dan yang lebih baru. Lebar item tidak dapat dimodifikasi oleh tindakan pengguna untuk mengubah ukurannya. |
|
Versi 6.00 dan yang lebih baru. Item menampilkan tombol pisahkan. Pemberitahuan HDN_DROPDOWN dikirim saat tombol pisahkan diklik. |
lParam
Jenis:
Data item yang ditentukan aplikasi.
iImage
Jenis: int
Indeks berbasis nol gambar dalam daftar gambar. Gambar yang ditentukan akan ditampilkan dalam item header selain gambar apa pun yang ditentukan di bidang hbm
iOrder
Jenis: int
Urutan item muncul dalam kontrol header, dari kiri ke kanan. Artinya, nilai untuk item paling kiri adalah 0. Nilai untuk item berikutnya di sebelah kanan adalah 1, dan sebagainya.
type
Jenis: UINT
Jenis filter yang ditentukan oleh pvFilter. Jenis yang mungkin meliputi:
| Nilai | Arti |
|---|---|
|
Data string. |
|
Data numerik. |
|
AbaikanpvFilter |
|
Versi 6.00 dan yang lebih baru. Data tanggal. Anggota |
pvFilter
Jenis:
Alamat item data yang ditentukan aplikasi. Jenis filter data ditentukan dengan mengatur nilai bendera anggota. Gunakan bendera HDFT_ISSTRING untuk menunjukkan string dan HDFT_ISNUMBER untuk menunjukkan bilangan bulat. Ketika bendera HDFT_ISSTRING digunakan
state
Jenis: UINT
Negara bagian. Satu-satunya nilai yang valid dan didukung untuk anggota ini adalah sebagai berikut:
| Nilai | Arti |
|---|---|
|
Item memiliki fokus keyboard. |
Komentar
Nota
Header commctrl.h mendefinisikan HDITEM 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
| Syarat | Nilai |
|---|---|
| klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| server minimum yang didukung |
Windows Server 2003 [hanya aplikasi desktop] |
| Header |
commctrl.h |