IMenuButton::AddButton メソッド (mmc.h)

IMenuButton::AddButton メソッドを使用すると、ユーザーは特定のビューの MMC メニューバーにボタンを追加できます。

構文

HRESULT AddButton(
  [in] int      idCommand,
  [in] LPOLESTR lpButtonText,
  [in] LPOLESTR lpTooltipText
);

[in] idCommand

メニューバーに追加するボタンを一意に識別するユーザー指定の値を指定する値。

[in] lpButtonText

ボタンに表示されるテキスト値 (null で終わる文字列) へのポインター。

[in] lpTooltipText

ユーザーがボタンにマウスポインターを置いたときに表示されるテキスト値 (null で終わる文字列) へのポインター。

このメソッドは、これらの値のいずれかを返すことができます。

特定のビューの MMC メニューバーに追加されたボタンは、既に存在するボタンに常に追加されます。メニューボタンの初期状態は非表示で無効になっています。

スナップインがフォーカスを失うと、これらのボタンはメニューバーから自動的に削除されます。その結果、スナップインがフォーカスを取得するたびに追加する必要があります。

このメソッドは、プライマリスナップインまたは拡張スナップインによって呼び出すことができます。