TabCtrl_GetItem マクロ (commctrl.h)

  • [アーティクル]

タブ コントロール内のタブに関する情報を取得します。 このマクロを使用することも、TCM_GETITEM メッセージを明示的に送信することもできます。

構文

BOOL TabCtrl_GetItem(
   HWND     hwnd,
   int      iItem,
   LPTCITEM pitem
);

パラメーター

hwnd

型: HWND

タブ コントロールへのハンドル。

iItem

型: int

タブのインデックス。

pitem

型: LPTCITEM

タブに関する情報を取得および受信する情報を指定する TCITEM 構造体へのポインター。メッセージが送信されると、mask メンバーは、返す属性を指定します。 mask メンバーがTCIF_TEXT値を指定する場合、pszText メンバーには項目テキストを受け取るバッファーのアドレスが含まれている必要があり、cchTextMax メンバーはバッファーのサイズを指定する必要があります。

戻り値

型: BOOL

成功した場合 TRUE を返し、それ以外の場合は FALSE 返します。

備考

TCIF_TEXT フラグが、TCITEM 構造体の マスク メンバーに設定されている場合、コントロールは、要求されたテキストでバッファーを埋める代わりに、構造体の pszText メンバーを新しいテキストを指すように変更できます。 コントロールは、pszText メンバーを NULL に設定して、アイテムに関連付けられているテキストがないことを示す場合があります。

必要条件

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