TCITEMHEADERW 構造体 (commctrl.h)

  • [アーティクル]

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

構文

typedef struct tagTCITEMHEADERW {
  UINT   mask;
  UINT   lpReserved1;
  UINT   lpReserved2;
  LPWSTR pszText;
  int    cchTextMax;
  int    iImage;
} TCITEMHEADERW, *LPTCITEMHEADERW;

メンバー

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 は親ウィンドウのテキストとは反対の方向に読み取られます。

Note

commctrl.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして TCITEMHEADER を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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