T (commctrl.h)

指定或接收索引標籤的屬性。它會與 TCM_INSERTITEM、 TCM_GETITEM和 TCM_SETITEM 訊息搭配使用。 這個結構會取代 TC_ITEMHEADER 結構。

語法

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

成員

mask

類型： UINT

值，指定要擷取或設定的成員。 此成員可以是下列值的組合：

值	意義
TCIF_IMAGE	iImage成員有效。
TCIF_RTLREADING	pszText指向的字串會顯示在與父視窗中文字相反的方向。
TCIF_TEXT	pszText成員有效。

lpReserved1

類型： UINT

保留的成員。 請勿使用。

lpReserved2

類型： UINT

保留的成員。 請勿使用。

pszText

類型： LPTSTR

如果設定專案資訊，則為 Null 終止字串的位址，其中包含索引標籤文字。 如果正在擷取專案資訊，這個成員會指定接收索引標籤文字的緩衝區位址。

cchTextMax

類型： int

pszText 成員指向的緩衝區大小。 如果結構未收到資訊，則會忽略這個成員。

iImage

類型： int

索引到索引標籤控制項的影像清單，如果沒有索引標籤的影像，則為 -1。

備註

一般而言，視窗會顯示由左至右 (LTR) 的文字。 Windows 可以 鏡像 顯示希伯來文或阿拉伯文等語言，以從右至左 (RTL) 。 一般而言， pszText 會顯示與其父視窗中文字相同的方向。 如果已設定TCIF_RTLREADING， pszText 會從父視窗中的文字相反方向讀取。

注意

commctrl.h 標頭會將 TCITEMHEADER 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
標頭	commctrl.h