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 |
---|---|
|
Anggota iImage valid. |
|
Anggota lParam valid. |
|
String yang ditujukan oleh pszText akan ditampilkan ke arah yang berlawanan dengan teks di jendela induk. |
|
Versi 4.70. Anggota dwState valid. |
|
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 |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk