IMenuButton::AddButton-Methode (mmc.h)

Mit der IMenuButton::AddButton-Methode kann ein Benutzer der MMC-Menüleiste für eine bestimmte Ansicht eine Schaltfläche hinzufügen.

Syntax

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

Parameter

[in] idCommand

Ein -Wert, der einen vom Benutzer bereitgestellten Wert angibt, der die Schaltfläche eindeutig identifiziert, die der Menüleiste hinzugefügt werden soll.

[in] lpButtonText

Ein Zeiger auf den Textwert (eine NULL-Zeichenfolge), die auf der Schaltfläche angezeigt werden soll.

[in] lpTooltipText

Ein Zeiger auf den Textwert (eine NULL-Zeichenfolge), die angezeigt werden soll, wenn der Benutzer den Mauszeiger auf der Schaltfläche platziert.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Hinweise

Schaltflächen, die der MMC-Menüleiste für eine bestimmte Ansicht hinzugefügt werden, werden immer an die bereits vorhandenen Schaltflächen angefügt. Der Anfangszustand einer Menüschaltfläche ist ausgeblendet und deaktiviert.

Wenn das Snap-In den Fokus verliert, werden diese Schaltflächen automatisch aus der Menüleiste entfernt. Daher müssen sie jedes Mal hinzugefügt werden, wenn das Snap-In den Fokus erhält.

Diese Methode kann von primären Snap-Ins oder Erweiterungs-Snap-Ins aufgerufen werden.

Anforderungen

Weitere Informationen

IMenuButton