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 ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして TCITEMHEADER を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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