Freigeben über


Anwendungsmenü

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

Einleitung

Das Anwendungsmenü besteht aus einem Dropdown-Schaltflächen-Steuerelement, das ein Menü mit Befehlen anzeigt, die Funktionen für ein vollständiges Projekt verfügbar machen, z. B. ein gesamtes Dokument, ein Bild oder einen Film. Beispiele sind die befehle New, Open, Saveund Exit Commands.

Der folgende Screenshot veranschaulicht das Anwendungsmenü.

Screenshot des Anwendungsmenüs und der Liste der zuletzt verwendeten Elemente des Paint für Windows 7-Menübands.

Komponenten des Anwendungsmenüs

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

Anmerkung

Windows 8 und höher: Schaltflächensymbol "Anwendungsmenü" wurde in Bezeichnung geändert: Datei-. Es wird empfohlen, "Datei" nicht als Bezeichnung für ihre eigenen Registerkarten zu verwenden.

 

Screenshot der Schaltfläche

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

Screenshot des Menüs

Anmerkung

Es gibt keine Auswirkungen auf die Registerkarte, die festgelegt wird, wenn auf die Schaltfläche "Anwendungsmenü" geklickt wird. Stattdessen wechselt der Fokus in das Menü.

 

Das Anwendungsmenü enthält zwei Bereiche: eine Liste von Befehlen, die durch ein oder mehrere MenuGroup--Elemente dargestellt werden, und eine Liste "Zuletzt verwendete Elemente" durch ein ApplicationMenu.RecentItems--Element dargestellt.

Menügruppe "Anwendung"

Das ApplicationMenu-Element muss mindestens ein MenuGroup-element untergeordnetes 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 dargestellt.

Screenshot einer Menügruppe des Anwendungsmenüs.

Es folgt eine Liste der Einschränkungen für ein MenuGroup- Element eines Anwendungsmenüs:

Wenn ein Button- in einer MenuGroup-verwendet wird, wird der Wert Command.LabelTitle im Menü und die Werte von Command.TooltipTitle und Command.TooltipDescription als QuickInfo angezeigt, wie im folgenden Screenshot gezeigt.

Screenshot eines Schaltflächensteuerelements in einem Anwendungsmenü.

Wenn eine Drop-Down-Schaltfläche, geteilte Schaltfläche, Drop-Down Katalogoder Geteilte Schaltflächenkatalog im Anwendungsmenü verwendet wird, wird der Menübereich als Flyout angezeigt, das den Zuletzt verwendeten Elemente Bereich verdeckt und verdeckt.

Für Geteilte Schaltfläche und Drop-Down Schaltflächen--Steuerelemente wird der Wert Command.LabelDescription- im Flyoutmenü inline angezeigt, um Benutzern die Ermittlung der Befehlsfunktionalität visuell zu erleichtern. Der angezeigte Wert Command.LabelDescription- wird programmgesteuert über eine zweizeilige Spanne aufgeteilt, und es wird versucht, den Wert genau über den Zuletzt verwendeten Elemente Bereich darunter anzupassen. Wenn der wert Command.LabelDescript ion nicht passt, wird das Flyout erweitert, um den längsten Command.Comment-Wert im MenuGroup-aufzunehmen.

Der folgende Screenshot veranschaulicht diese Verhaltensweisen in einem Geteilten Schaltflächen- Flyout.

Screenshot eines Listensteuerelement-Flyouts in einem Anwendungsmenü.

Mit einer Drop-Down Gallery und einem Geteilten Schaltflächenkatalogwerden nur eine Beschriftung und ein Bild angezeigt.

Größe des Anwendungsmenüs

Die Größe des Anwendungsmenüs wird vom Menübandframework behandelt. 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 Verschiebungsanzeigen beim Scrollen.

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 in der Menüband-Benutzeroberfläche aktualisiert, indem der dem Steuerelement zugeordnete Befehl durch einen Aufruf der IUIFramework::InvalidateUICommand-Methode ungültig wird. Das Ungültigkeitsereignis wird behandelt, und die Eigenschaftenaktualisierungen werden durch die IUICommandHandler::UpdateProperty Rückrufmethode definiert.

Die IUICommandHandler::UpdateProperty Rückrufmethode wird nicht ausgeführt, und die Anwendung wird erst nach einem aktualisierten Eigenschaftswert abgefragt, wenn die Eigenschaft vom Framework benötigt wird. Beispielsweise erfordert das Framework die Eigenschaft, wenn eine Registerkarte aktiviert wird und ein Steuerelement in der Menüband-Benutzeroberfläche angezeigt wird, oder wenn eine QuickInfo angezeigt wird.

Eigenschaftsschlüssel Notizen
UI_PKEY_TooltipDescription Kann nur durch Ungültigheit aktualisiert werden.
UI_PKEY_TooltipTitle Kann nur durch Ungültigheit aktualisiert werden.

 

Windows Ribbon Framework-Steuerelementbibliothek

ApplicationMenu-Markupelement