TBN_GETBUTTONINFO通知コード

  • [アーティクル]

ツール バーのカスタマイズ情報を取得し、ツール バーに加えられた変更をツールバーの親ウィンドウに通知します。 この通知コードは、 WM_NOTIFY メッセージの形式で送信されます。

TBN_GETBUTTONINFO 

    lpnmtb = (LPNMTOOLBAR) lParam;

パラメーター

lParam

NMTOOLBAR 構造体へのポインター。 iItem メンバーは 0 から始まるインデックスを指定します。このインデックスは、[ツール バーのカスタマイズ] ダイアログ ボックスに使用可能なボタンとツール バーに表示されるボタンの数を示します。 pszText メンバーは現在のボタン テキストのアドレスを指定し、cchText はその長さを文字数で指定します。 アプリケーションは、ボタンに関する情報を構造体に入力する必要があります。

戻り値

ボタン情報が指定した構造体にコピーされた場合は TRUE 、それ以外の場合は FALSE を 返します。

解説

ツール バー コントロールはバッファーを割り当て、レシーバー (親ウィンドウ) はそのバッファーにテキストをコピーする必要があります。 cchText メンバーには、TBN_GETBUTTONINFOが親ウィンドウに送信されるときにツール バーによって割り当てられたバッファーの長さが含まれます。

要件

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