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).
Das Anwendungsmenü kann höchstens eine ApplicationMenu.RecentItems-Liste enthalten, die durch ein ApplicationMenu.RecentItems-Element dargestellt wird, um aktuelle Dokumente, Bilder, Filme und andere Projekte anzuzeigen, an denen ein Benutzer gearbeitet hat. Die Anzahl der aufgelisteten Elemente reicht von 0 bis zur maximalen Anzahl, 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, die Command.LabelDescription-Eigenschaft zu verwenden, um den vollständigen Pfad für den Dateispeicherort anzugeben, wie im folgenden Screenshot gezeigt.
Das RecentItems-Element verfügt über ein EnablePinning-Attribut , das, wenn auf truefestgelegt, ein Anheftsymbol rechts neben jedem Element in der Liste anzeigt, wie im folgenden Screenshot gezeigt.
Hinweis
Das Anheften ist standardmäßig aktiviert, wenn das EnablePinning-Attribut nicht angegeben ist.
Der Anheftungsalgorithmus soll verhindert, dass Elemente aus der Liste Zuletzt verwendete Elemente fallen. Der Algorithmus erzeugt das folgende Verhalten:
- Ein neues Element wird immer oben in der Liste Zuletzt verwendete Elemente hinzugefügt.
- Elemente werden im Laufe der Zeit in der Liste nach unten verschoben. Sobald die Liste voll ist (die maximale Anzahl von Elementen erreicht, die im Markup angegeben ist), fallen ältere Elemente vom Ende der Liste ab, da neue Elemente am Anfang der Liste hinzugefügt werden.
- Wenn ein Element bereits irgendwo in der Liste angezeigt wird, aber erneut zugegriffen wird, wird es wieder an den Anfang der Liste verschoben.
- Wenn ein Element angeheftet ist, bewegt es sich weiterhin in der Liste, fällt aber nicht vom unteren Rand ab. Wenn die Liste voll ist, fällt stattdessen das erste nicht angeheftete Element über dem angehefteten Element aus, 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 aufgehoben wird.
Eigenschaften der zuletzt verwendeten Elemente
Das Menübandframework definiert eine Auflistung von Eigenschaftenschlüsseln für das Steuerelement Zuletzt verwendete Elemente.
In der Regel wird eine Eigenschaft Zuletzt verwendete Elemente 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 von der IUICommandHandler::UpdateProperty-Rückrufmethode behandelt und die Eigenschaft aktualisiert.
Die IUICommandHandler::UpdateProperty-Rückrufmethode wird nicht ausgeführt, und die Anwendung wird nach einem aktualisierten Eigenschaftswert abgefragt, bis die Eigenschaft vom Framework erforderlich ist. Beispielsweise, wenn eine Registerkarte aktiviert ist und ein Steuerelement auf der Menüband-Benutzeroberfläche angezeigt wird, oder wenn eine QuickInfo angezeigt wird.
Hinweis
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.
| Eigenschaftenschlüssel | Hinweise |
|---|---|
| UI_PKEY_Keytip | Kann nur durch ungültige Aktualisierung aktualisiert werden. |
| UI_PKEY_RecentItems | Kann nur durch ungültige Aktualisierung 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 Daten zu erstellen, die vom Menübandframework zum Auffüllen der Liste Zuletzt verwendete Elemente des Anwendungsmenüs erforderlich sind.
Hinweis
Wenn Sie diese Methode verwenden, sollte der Listentyp den Wert ADLT_RECENTaufweisen.
Ein Beispiel zum Implementieren einer MRU-Elementliste in einer Menübandframeworkanwendung finden Sie im HTMLEditRibbon-Beispiel.
Zugehörige Themen