Struktur TCITEMHEADERA (commctrl.h)

Menentukan atau menerima atribut tab. Ini digunakan dengan pesan TCM_INSERTITEM, TCM_GETITEM, dan TCM_SETITEM . Struktur ini menggantikan struktur TC_ITEMHEADER .

Sintaks

typedef struct tagTCITEMHEADERA {
  UINT  mask;
  UINT  lpReserved1;
  UINT  lpReserved2;
  LPSTR pszText;
  int   cchTextMax;
  int   iImage;
} TCITEMHEADERA, *LPTCITEMHEADERA;

Anggota

mask

Jenis: UINT

Nilai yang menentukan anggota mana yang akan diambil atau diatur. Anggota ini bisa menjadi kombinasi dari nilai berikut:

Nilai	Makna
TCIF_IMAGE	Anggota iImage valid.
TCIF_RTLREADING	String yang ditujukkan oleh pszText akan ditampilkan ke arah yang berlawanan dengan teks di jendela induk.
TCIF_TEXT	Anggota pszText valid.

lpReserved1

Jenis: UINT

Anggota yang dipesan. Jangan gunakan.

lpReserved2

Jenis: UINT

Anggota yang dipesan. Jangan gunakan.

pszText

Jenis: LPTSTR

Alamat string yang dihentikan null yang berisi teks tab jika informasi item sedang diatur. Jika informasi item sedang diambil, anggota ini menentukan alamat buffer yang menerima teks tab.

cchTextMax

Jenis: int

Ukuran buffer yang ditujukkan oleh anggota pszText. Jika struktur tidak menerima informasi, anggota ini diabaikan.

iImage

Jenis: int

Indeks ke dalam daftar gambar kontrol tab, atau -1 jika tidak ada gambar untuk tab.

Keterangan

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, pszText akan ditampilkan ke arah yang sama dengan teks di jendela induknya. Jika TCIF_RTLREADING diatur, pszText akan membaca ke arah yang berlawanan dari teks di jendela induk.

Catatan

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