Struktur HDITEMA (commctrl.h)

  • Artikel

Berisi informasi tentang item dalam kontrol header. Struktur ini menggantikan struktur HD_ITEM .

Sintaks

typedef struct _HD_ITEMA {
  UINT    mask;
  int     cxy;
  LPSTR   pszText;
  HBITMAP hbm;
  int     cchTextMax;
  int     fmt;
  LPARAM  lParam;
  int     iImage;
  int     iOrder;
  UINT    type;
  void    *pvFilter;
  UINT    state;
} HDITEMA, *LPHDITEMA;

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 Makna
HDI_BITMAP
 Anggota hbm valid.
HDI_DI_SETITEM
 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.)
HDI_FORMAT
 Anggota fmt valid.
HDI_FILTER
 Jenis dan anggota pvFilter valid. Ini digunakan untuk memfilter nilai yang ditentukan dalam anggota jenis .
HDI_HEIGHT
 Sama seperti HDI_WIDTH.
HDI_IMAGE
 Anggota iImage valid dan menentukan gambar yang akan ditampilkan dengan item.
HDI_LPARAM
 Anggota lParam valid.
HDI_ORDER
 Anggota iOrder valid dan menentukan nilai pesanan item.
HDI_STATE

Versi 6.00 dan yang lebih baru. Anggota negara bagian valid.
HDI_TEXT
 Anggota pszText dan cchTextMax valid.
HDI_WIDTH
 Anggota cxy valid dan menentukan lebar item.

cxy

Jenis: int

Lebar atau tinggi item.

pszText

Jenis: LPTSTR

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 TCHARs pertama yang ditampilkan.

hbm

Jenis: HBITMAP

Handel ke bitmap item.

cchTextMax

Jenis: int

Panjang string item, dalam TCHARs. Jika teks sedang diambil dari kontrol, anggota ini harus berisi jumlah TCHARs di alamat yang ditentukan oleh pszText.

fmt

Jenis: int

Bendera yang menentukan format item.

Nilai Makna
Pembenaran Teks:
 Atur salah satu bendera berikut untuk menentukan pembenaran teks:
HDF_CENTER
 Isi item dipusatkan.
HDF_LEFT
 Isi item diratakan kiri.
HDF_RIGHT
 Isi item diratakan ke kanan.
Menampilkan:
 Atur salah satu bendera berikut untuk mengontrol tampilan:
HDF_BITMAP
 Item menampilkan bitmap.
HDF_BITMAP_ON_RIGHT
 Bitmap muncul di sebelah kanan teks.
HDF_OWNERDRAW
 Pemilik kontrol header menggambar item.
HDF_STRING
 Item menampilkan string.
Menggabungkan Bendera:
 Nilai sebelumnya dapat dikombinasikan dengan:
HDF_IMAGE
 Menampilkan gambar dari daftar gambar. Tentukan daftar gambar dengan mengirim pesan HDM_SETIMAGELIST . Tentukan indeks gambar di anggota iImage dari struktur ini.
HDF_JUSTIFYMASK
 Isolasi bit yang sesuai dengan tiga bendera pembenaran yang tercantum dalam tabel sebelumnya.
HDF_RTLREADING
 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 dengan 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.
HDF_SORTDOWN

Versi 6.00 dan yang lebih baru. Menggambar 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 digabungkan dengan HDF_IMAGE atau HDF_BITMAP.
HDF_SORTUP

Versi 6.00 dan yang lebih baru. Menggambar 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 digabungkan dengan HDF_IMAGE atau HDF_BITMAP.
HDF_CHECKBOX

Versi 6.00 dan yang lebih baru. Item menampilkan kotak centang. Bendera hanya valid ketika gaya HDS_CHECKBOXES pertama kali diatur pada kontrol header.
HDF_CHECKED

Versi 6.00 dan yang lebih baru. Item menampilkan kotak centang yang dicentang. Bendera hanya valid ketika HDF_CHECKBOX juga diatur.
HDF_FIXEDWIDTH

Versi 6.00 dan yang lebih baru. Lebar item tidak dapat diubah oleh tindakan pengguna untuk mengubah ukurannya.
HDF_SPLITBUTTON

Versi 6.00 dan yang lebih baru. Item menampilkan tombol pisah. Pemberitahuan HDN_DROPDOWN dikirim saat tombol pisahkan diklik.

lParam

Jenis: LPARAM

Data item yang ditentukan aplikasi.

iImage

Jenis: int

Indeks gambar berbasis nol dalam daftar gambar. Gambar yang ditentukan akan ditampilkan di item header selain gambar apa pun yang ditentukan di bidang hbm . Jika iImage diatur ke I_IMAGECALLBACK, kontrol meminta informasi teks untuk item ini dengan menggunakan kode pemberitahuan HDN_GETDISPINFO . Untuk menghapus gambar, atur nilai ini ke I_IMAGENONE.

iOrder

Jenis: int

Urutan item muncul di 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 Makna
HDFT_ISSTRING
 Data string.
HDFT_ISNUMBER
 Data numerik.
HDFT_HASNOVALUE
 Abaikan pvFilter.
HDFT_ISDATE

Versi 6.00 dan yang lebih baru. Data tanggal. Anggota pvFilter adalah penunjuk ke struktur SYSTEMTIME .

pvFilter

Jenis: batal*

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 pvFilter adalah penunjuk ke struktur HDTEXTFILTER .

state

Jenis: UINT

Negara bagian. Satu-satunya nilai yang valid dan didukung untuk anggota ini adalah sebagai berikut:

Nilai Makna
HDIS_FOCUSED
 Item memiliki fokus keyboard.

Keterangan

Catatan Comctl32.dll versi 6 tidak dapat didistribusikan ulang tetapi disertakan dalam Windows. Untuk menggunakan Comctl32.dll versi 6, tentukan dalam manifes. Untuk informasi selengkapnya tentang manifes, lihat Mengaktifkan Gaya Visual.
 

Catatan

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

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