共用方式為

TCITEMHEADERA 結構 （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