TCITEMW 構造体 (commctrl.h)

タブ 項目の属性を指定または受信します。 これは、 TCM_INSERTITEM、TCM_GETITEM、 およびTCM_SETITEMメッセージと共 に 使用されます。 この構造体は 、TC_ITEM 構造体よりも優先されます。

構文

typedef struct tagTCITEMW {
  UINT   mask;
  DWORD  dwState;
  DWORD  dwStateMask;
  LPWSTR pszText;
  int    cchTextMax;
  int    iImage;
  LPARAM lParam;
} TCITEMW, *LPTCITEMW;

メンバー

mask

型: UINT

取得または設定するメンバーを指定する値。 このメンバーには、次の値の組み合わせを指定できます。

値	意味
TCIF_IMAGE	iImage メンバーは有効です。
TCIF_PARAM	lParam メンバーは有効です。
TCIF_RTLREADING	pszText が指す文字列は、親ウィンドウのテキストと反対の方向に表示されます。
TCIF_STATE	バージョン 4.70。 dwState メンバーは有効です。
TCIF_TEXT	pszText メンバーは有効です。

dwState

種類: DWORD

バージョン 4.70。 情報を取得する場合のアイテムの現在の状態を指定します。 アイテム情報が設定されている場合、このメンバーにはアイテムに設定する状態値が含まれます。 有効なタブ コントロール項目の状態の一覧については、「 タブ コントロール項目の状態」を参照してください。 このメンバーは、 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 プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして TCITEM を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
Header	commctrl.h