メッセージのTB_GETBUTTONTEXT
ツール バーのボタンの表示テキストを取得します。
パラメーター
-
wParam
-
テキストを取得するボタンのコマンド識別子。
-
lParam
-
ボタン テキストを受け取るバッファーへのポインター。
戻り値
lParam が指す文字列の長さを文字数で返します。 長さには、終端の null 文字は含まれません。 失敗した場合、戻り値は -1 になります。
解説
セキュリティの警告: このメッセージを誤って使用すると、プログラムのセキュリティが損なわれる可能性があります。 このメッセージでは、バッファーのサイズを把握する方法は提供されません。 このメッセージを使用する場合、最初に lParam で NULL を渡すメッセージを呼び出すと、必要な NULL を除く文字数が返されます。 次に、もう一度メッセージを呼び出して文字列を取得します。 続行する前に、「セキュリティに関する考慮事項: Microsoft Windows コントロール」を確認する必要があります。
返される文字列は、ボタンによって現在表示されているテキストに対応します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
| Header |
|
| Unicode 名と ANSI 名 |
TB_GETBUTTONTEXTW (Unicode) と TB_GETBUTTONTEXTA (ANSI) |