次の方法で共有

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を します。 情報を取得する場合のアイテムの現在の状態を指定します。 項目情報が設定されている場合、このメンバーには項目に設定する状態値が含まれます。 有効なタブ コントロール項目の状態の一覧については、「タブ コントロール項目の状態」を参照してください。 このメンバーは、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 を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

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