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

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

值 意義
TCIF_IMAGE
 iImage成員有效。
TCIF_PARAM
 lParam成員有效。
TCIF_RTLREADING
 pszText 所指向的字串會以父視窗中文字相反的方向顯示。
TCIF_STATE

4.70 版。 dwState 成員有效。
TCIF_TEXT
 pszText 成員有效。

dwState

類型： DWORD

4.70 版。 指定正在擷取資訊時專案的目前狀態。 如果設定專案資訊，此成員會包含要為項目設定的狀態值。 如需有效索引標籤控件項目狀態的清單，請參閱 Tab 控件項目狀態。 TCM_INSERTITEM 訊息中 會忽略這個成員。

dwStateMask

類型： DWORD

4.70 版。 指定 dwState 成員的哪些位包含有效資訊。 TCM_INSERTITEM 訊息中 會忽略這個成員。

pszText

類型： LPTSTR

當設定項目資訊時，包含索引標籤文字之 Null 終止字串的指標。 如果正在擷取項目資訊，此成員會指定接收索引標籤文字的緩衝區位址。

cchTextMax

類型： int

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

iImage

類型： int

索引在索引標籤元件的影像清單中，如果沒有索引標籤的影像，則為 -1。

lParam

類型： LPARAM

與索引標籤控件專案相關聯的應用程式定義數據。 如果每個索引標籤有多個或少於 4 個字節的應用程式定義數據，應用程式必須定義結構，並使用它，而不是 TCITEM 結構。 應用程式定義結構的第一個成員必須是 TCITEMHEADER 結構。

備註

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

注意

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

規格需求

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