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