TCM_GETITEM

タブコントロールのタブに関する情報を取得します。

このメッセージを送信するには SendMessage 関数を使います。

#define  TCM_GETITEM    0x1305

wParam = iItem;
lParam = pitem;

パラメータ

iItem

情報を取得するタブの位置の 0 から始まるインデックスを指定します。

pitem

タブの情報を格納する TCITEM 構造体のアドレスを指定します。 mask メンバにはどの属性を取得するかを指定しておきます。

mask メンバに TCIF_TEXT 値を指定した場合には、 pszText メンバにアイテムのテキストを格納するバッファのアドレスを、 cchTextMax メンバにバッファのサイズをそれぞれ指定しなければなりません。

戻り値

成功すると 0 以外の値が返ります。

失敗すると 0 が返ります。

解説

mask メンバに TCIF_TEXT 値を指定したときに、アイテムに関連付けられたテキストがない場合には、 pszText メンバに 0 (NULL) が格納されます。

対応情報

Windows 95 以降 / Windows NT 3.51 以降