共用方式為

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

要求

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