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.

Sintaksis

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:

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 diatur 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 anggota dwState mana yang berisi informasi yang valid. Anggota ini diabaikan dalam pesan TCM_INSERTITEM.

pszText

Jenis: LPTSTR

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

cchTextMax

Jenis: int

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

iImage

Jenis: int

Indeks di 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 .

Komentar

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.

Persyaratan