Anwendungsmenü

Das Anwendungsmenü ist das Standard Menü für eine Anwendung, die das Windows-Menübandframework implementiert.

• Introduction (Einführung)
• Komponenten des Anwendungsmenüs
  • Menügruppe für das Anwendungsmenü
• Größenanpassung des Anwendungsmenüs
• Eigenschaften des Anwendungsmenüs
• Zugehörige Themen

Einführung

Das Anwendungsmenü besteht aus einem Dropdownschaltfläche-Steuerelement, das ein Menü mit Befehlen anzeigt, die Funktionen für ein vollständiges Projekt verfügbar machen, z. B. ein gesamtes Dokument, Bild oder Film. Beispiele hierfür sind die Befehle New, Open, Save und Exit .

Der folgende Screenshot veranschaulicht das Anwendungsmenü.

Komponenten des Anwendungsmenüs

Das Anwendungsmenü ist ein obligatorisches Element in jeder Menübandanwendung. Der Einstiegspunkt in das Anwendungsmenü ist eine charakteristische Schaltfläche, die als erstes Element in der Registerkartenzeile angezeigt wird, wie im folgenden Screenshot gezeigt.

Wenn Sie darauf klicken, zeigt diese Schaltfläche das umfangreiche Menü an, das im folgenden Screenshot (das Anwendungsmenü von WordPad für Windows 7) angezeigt wird.

Das Anwendungsmenü enthält zwei Bereiche: eine Liste der Befehle, die durch ein oder mehrere MenuGroup-Elemente dargestellt werden, und eine Liste der zuletzt verwendeten Elemente , die durch ein ApplicationMenu.RecentItems-Element dargestellt wird.

Menügruppe für das Anwendungsmenü

Das ApplicationMenu-Element muss mindestens ein untergeordnetes MenuGroup-Element enthalten, das eine Liste von Befehlen auf Anwendungsebene verfügbar macht. Wenn mehrere MenuGroup-Elemente deklariert werden, wird eine Trennlinie zwischen den Gruppen gezeichnet, wie im folgenden Screenshot gezeigt.

Im Folgenden ist eine Liste der Einschränkungen für ein MenuGroup-Element eines Anwendungsmenüs aufgeführt:

• Alle MenuGroup-Elemente müssen mit dem Class-AttributwertMajorItemsdeklariert werden.

• Eine Menügruppe des Anwendungsmenüs unterstützt nur die Steuerelemente Schaltfläche, Dropdownschaltfläche, Geteilte Schaltfläche, Dropdownkatalog und Spaltenschaltflächenkatalog .

  ![Wichtig]
  Befehlskataloge sind der einzige Katalogtyp, der im Anwendungsmenü unterstützt wird. Weitere Informationen zu Katalogsteuerelementen finden Sie unter Arbeiten mit Katalogen.

   

Wenn eine Schaltfläche in einer MenuGroup verwendet wird, wird der Wert von Command.LabelTitle im Menü angezeigt, und die Werte von Command.TooltipTitle und Command.TooltipDescription werden als QuickInfo angezeigt, wie im folgenden Screenshot gezeigt.

Wenn eine Dropdownschaltfläche, eine Geteilte Schaltfläche, ein Dropdownkatalog oder ein Katalog für geteilte Schaltflächen im Anwendungsmenü verwendet wird, wird der Menübereich als Flyout angezeigt, das den Bereich Zuletzt verwendete Elemente abdeckt und verdeckt.

Bei Steuerelementen Split Button und Drop-Down Button wird der Wert von Command.LabelDescription inline im Flyoutmenü angezeigt, um Benutzer visuell bei der Ermittlung der Befehlsfunktionalität zu unterstützen. Der angezeigte Wert von Command.LabelDescription wird programmgesteuert über eine zweizeilige Spanne unterbrochen, und es wird versucht, den Wert genau über den Darunterbereich Zuletzt verwendete Elemente anzupassen. Wenn der Command.LabelDescription-Wert nicht passt, wird das Flyout erweitert, um den längsten Command.Comment-Wert in der MenuGroup aufzunehmen.

Der folgende Screenshot veranschaulicht diese Verhaltensweisen in einem Flyout für geteilte Schaltflächen .

Bei einem Dropdownkatalog und einem Katalog für geteilte Schaltflächen werden nur eine Bezeichnung und ein Bild angezeigt.

Größenanpassung des Anwendungsmenüs

Die Größe des Anwendungsmenüs wird vom Menübandframework verarbeitet. Wenn sehr lange Zeichenfolgen für den Wert von Command.LabelTitle oder Command.LabelDescription angegeben werden oder eine lange Liste von Befehlen verwendet wird, passt das Menü seine Größe an den Inhalt an. Einige Anpassungsformen umfassen das Erweitern der Größe von Flyouts oder Menübereichen und das Hinzufügen von Schwenkanzeigen, wenn ein Bildlauf erforderlich ist.

Eigenschaften des Anwendungsmenüs

Das Menübandframework definiert eine Auflistung von Eigenschaftenschlüsseln für das Anwendungsmenü-Steuerelement.

In der Regel wird eine Anwendungsmenüeigenschaft auf der Menübandbenutzeroberfläche aktualisiert, indem der dem Steuerelement zugeordnete Befehl durch einen Aufruf der IUIFramework::InvalidateUICommand-Methode ungültig wird. Das Invaliditätsereignis wird behandelt, und die Eigenschaftenupdates werden von der IUICommandHandler::UpdateProperty-Rückrufmethode definiert.

Die IUICommandHandler::UpdateProperty-Rückrufmethode wird nicht ausgeführt, und die Anwendung wird erst nach einem aktualisierten Eigenschaftswert abgefragt, bis die Eigenschaft vom Framework erforderlich ist. Beispielsweise erfordert das Framework die -Eigenschaft, wenn eine Registerkarte aktiviert und ein Steuerelement auf der Menübandbenutzeroberfläche angezeigt wird, oder wenn eine QuickInfo angezeigt wird.

Zugehörige Themen

Windows Ribbon Framework-Steuerelementbibliothek

ApplicationMenu-Markupelement