TB_GETBUTTONTEXT メッセージ

ツール バーのボタンの表示テキストを取得します。

パラメーター

wParam

テキストを取得するボタンのコマンド識別子。

lParam

ボタン テキストを受け取るバッファーへのポインター。

戻り値

lParam が指す文字列の長さを文字数で返します。 長さには、終端の null 文字は含まれません。 失敗した場合、戻り値は -1 になります。

解説

セキュリティの警告: このメッセージを誤って使用すると、プログラムのセキュリティが損なわれる可能性があります。 このメッセージは、バッファーのサイズを把握する方法を提供しません。 このメッセージを使用する場合は、最初に lParam で NULL を渡すメッセージを呼び出します。これにより、必要な NULL を除く文字数が返されます。 次に、2 回目にメッセージを呼び出して文字列を取得します。 続行する前に、「 セキュリティに関する考慮事項: Microsoft Windows コントロール」 を確認する必要があります。

返される文字列は、 ボタンによって現在表示されているテキストに対応します。

必要条件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー	Commctrl.h
Unicode 名と ANSI 名	TB_GETBUTTONTEXTW (Unicode) と TB_GETBUTTONTEXTA (ANSI)

関連項目

参照

TB_GETBUTTONINFO

TB_GETSTRING

TB_SETBUTTONINFO