Freigeben über


Zuletzt verwendete Elemente

Die Liste "Zuletzt verwendete Elemente" ist ein Bereich im Anwendungsmenü, in dem die zuletzt verwendeten Elemente (MRU) für eine Anwendung angezeigt werden.

Details

Der folgende Screenshot veranschaulicht eine Liste der zuletzt verwendeten Elemente aus WordPad für Windows 7.

Screenshot der Liste der zuletzt verwendeten Elemente im Microsoft Paint-Menüband.

Das Anwendungsmenü- kann höchstens ein ApplicationMenu.RecentItems Liste enthalten, dargestellt durch ein ApplicationMenu.RecentItems- Element, um zuletzt verwendete Dokumente, Bilder, Filme und andere Projekte anzuzeigen, an denen ein Benutzer gearbeitet hat. Die Anzahl der aufgelisteten Elemente reicht von Null bis zur maximalen Zahl, die im Markup angegeben ist, mit einem Standardwert von zehn. Die zuletzt verwendeten Elemente werden als nummerierte Liste von Zeichenfolgen angezeigt, die Dateinamen angeben. Es wird empfohlen, dass die Command.LabelDescription Eigenschaft verwendet werden, um den vollständigen Pfad für den Dateispeicherort anzugeben, wie im folgenden Screenshot dargestellt.

Screenshot einer Liste der zuletzt verwendeten Elemente in einem Anwendungsmenü.

Das RecentItems--Element verfügt über ein EnablePinning- Attribut, das, falls auf truefestgelegt, ein Pinsymbol rechts neben jedem Element in der Liste anzeigt, wie im folgenden Screenshot gezeigt.

Anmerkung

Das Anheften ist standardmäßig aktiviert, wenn das attribut EnablePinning nicht angegeben ist.

 

Screenshot der zuletzt verwendeten Elemente in einem Anwendungsmenü anheften.

Der Anheftungsalgorithmus soll verhindern, dass Elemente aus der Zuletzt verwendeten Elemente Liste fallen. Der Algorithmus erzeugt das folgende Verhalten:

  • Ein neues Element wird immer am Anfang der Zuletzt verwendeten Elemente Liste hinzugefügt.
  • Elemente werden im Laufe der Zeit in der Liste nach unten verschoben. Sobald die Liste voll ist (erreicht die maximale Anzahl von Elementen, die im Markup angegeben sind), fallen ältere Elemente vom Ende der Liste ab, wenn neue Elemente am Anfang der Liste hinzugefügt werden.
  • Wenn ein Element bereits an einer beliebigen Stelle in der Liste angezeigt wird, aber erneut darauf zugegriffen wird, wird es wieder an den Anfang der Liste verschoben.
  • Wenn ein Element angeheftet ist, wird es weiterhin in der Liste nach unten bewegt, fällt aber nicht vom Unteren ab. Wenn die Liste vollständig ist, wird das erste nicht angeheftete Element oberhalb des angehefteten Elements deaktiviert, wenn der Liste ein neues Element hinzugefügt wird.
  • Wenn die Anzahl der angehefteten Elemente jemals die maximale Anzahl von Elementen erreicht, werden der Liste keine neuen Elemente hinzugefügt, bis ein Element gelöst wird.

Eigenschaften der zuletzt verwendeten Elemente

Das Menübandframework definiert eine Auflistung von Eigenschaftsschlüsseln für das Steuerelement "Zuletzt verwendete Elemente".

In der Regel wird eine Eigenschaft "Zuletzt verwendete Elemente" 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 durch die IUICommandHandler::UpdateProperty Rückrufmethode definierten Eigenschaftenaktualisierungen.

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

Anmerkung

In einigen Fällen kann eine Eigenschaft über die IUIFramework::GetUICommandProperty Methode abgerufen und mit der IUIFramework::SetUICommandProperty--Methode festgelegt werden.

 

In der folgenden Tabelle sind die Eigenschaftenschlüssel aufgeführt, die dem Steuerelement "Zuletzt verwendete Elemente" zugeordnet sind.

Eigenschaftsschlüssel Notizen
UI_PKEY_Keytip Kann nur durch Ungültigheit aktualisiert werden.
UI_PKEY_RecentItems Kann nur durch Ungültigheit aktualisiert werden.

 

Bemerkungen

Die IApplicationDocumentLists::GetList Methode kann verwendet werden, um die Windows Shell MRU-Liste für die Menübandanwendung abzurufen. Das von dieser Methode abgerufene Objekt kann dann von der Anwendung verwendet werden, um die vom Menübandframework erforderlichen Daten zu erstellen, um die Zuletzt verwendeten Elemente Liste der Anwendungsmenü-aufzufüllen.

Anmerkung

Bei Verwendung dieser Methode sollte Listentyp den Wert ADLT_RECENTaufweisen.

 

Ein Beispiel zum Implementieren einer MRU-Elementliste in einer Menübandframeworkanwendung finden Sie im HTMLEditRibbon-Beispiel-.

Windows Ribbon Framework-Steuerelementbibliothek

Markupelement "Zuletzt verwendete Elemente"