Struktur TCITEMA (commctrl.h)

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

Sintaks

typedef struct tagTCITEMA {
  UINT   mask;
  DWORD  dwState;
  DWORD  dwStateMask;
  LPSTR  pszText;
  int    cchTextMax;
  int    iImage;
  LPARAM lParam;
} TCITEMA, *LPTCITEMA;

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_PARAM	Anggota lParam valid.
TCIF_RTLREADING	String yang ditujukan oleh pszText akan ditampilkan ke arah yang berlawanan dengan teks di jendela induk.
TCIF_STATE	Versi 4.70. Anggota dwState valid.
TCIF_TEXT	Anggota pszText valid.

dwState

Jenis: DWORD

Versi 4.70. Menentukan status item saat ini jika informasi sedang diambil. Jika informasi item sedang diatur, anggota ini berisi nilai status yang akan ditetapkan untuk item tersebut. Untuk daftar status item kontrol tab yang valid, lihat Status Item Kontrol Tab. Anggota ini diabaikan dalam pesan TCM_INSERTITEM .

dwStateMask

Jenis: DWORD

Versi 4.70. Menentukan bit mana dari anggota dwState yang berisi informasi yang valid. Anggota ini diabaikan dalam pesan TCM_INSERTITEM .

pszText

Jenis: LPTSTR

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

cchTextMax

Jenis: int

Ukuran dalam TCHARdari buffer yang diacu oleh anggota pszText . Jika struktur tidak menerima informasi, anggota ini diabaikan.

iImage

Jenis: int

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

lParam

Jenis: LPARAM

Data yang ditentukan aplikasi yang terkait dengan item kontrol tab. Jika ada lebih atau kurang dari 4 byte data yang ditentukan aplikasi per tab, aplikasi harus menentukan struktur dan menggunakannya alih-alih struktur TCITEM . Anggota pertama dari struktur yang ditentukan aplikasi harus merupakan struktur TCITEMHEADER .

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 TCITEM 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