TCITEMA 結構 (commctrl.h)
指定或接收索引標籤項目的屬性。 它會與 TCM_INSERTITEM、TCM_GETITEM和 TCM_SETITEM 訊息搭配使用。 這個結構會取代 TC_ITEM 結構。
語法
typedef struct tagTCITEMA {
UINT mask;
DWORD dwState;
DWORD dwStateMask;
LPSTR pszText;
int cchTextMax;
int iImage;
LPARAM lParam;
} TCITEMA, *LPTCITEMA;
成員
mask
類型:UINT
值,指定要擷取或設定的成員。 這個成員可以是下列值的組合:
價值 | 意義 |
---|---|
|
iImage 成員有效。 |
|
lParam 成員有效。 |
|
pszText 所指向的字串會顯示在父視窗中文字相反的方向。 |
|
4.70 版。 dwState 成員有效。 |
|
pszText 成員有效。 |
dwState
類型:DWORD
4.70 版。 如果正在擷取資訊,則指定專案的目前狀態。 如果正在設定專案資訊,這個成員會包含要為項目設定的狀態值。 如需有效索引標籤控制項項目狀態的清單,請參閱 Tab 控制項項目狀態。 TCM_INSERTITEM 訊息中會忽略此成員。
dwStateMask
類型:DWORD
4.70 版。 指定 dwState 成員包含有效資訊的位。 TCM_INSERTITEM 訊息中會忽略此成員。
pszText
類型:LPTSTR
在設定項目資訊時,包含索引標籤文字之 Null 終止字串的指標。 如果正在擷取專案資訊,這個成員會指定接收製表元文字之緩衝區的位址。
cchTextMax
類型:int
iImage
類型:int
索引標籤的影像清單中,如果沒有索引標籤的影像,則 -1。
lParam
類型:LPARAM
與索引標籤控件專案相關聯的應用程式定義數據。 如果每個索引標籤有多個或少於 4 個字節的應用程式定義資料存在,應用程式必須定義結構,並使用它,而不是 TCITEM 結構。 應用程式定義結構的第一個成員必須是 TCITEMHEADER 結構的
言論
一般而言,視窗會顯示由左至右的文字(LTR)。 Windows 可以 鏡像 來顯示語言,例如希伯來文或從右至左讀取的阿拉伯文(RTL)。 一般而言,pszText 會顯示在其父視窗中的文字方向相同。 如果設定TCIF_RTLREADING,pszText 會從父視窗中的文字相反方向讀取。
注意
commctrl.h 標頭會將 TCITEM 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
支援的最低伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
標頭 | commctrl.h |