Vcl.JumpList.TJumpList

• Übergeordnet: Vcl.JumpList
• Methoden
• Eigenschaften
• Ereignisse
• Felder

Delphi

TJumpList = class(TCustomJumpList)

C++

class PASCALIMPLEMENTATION TJumpList : public TCustomJumpList

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
class	public	Vcl.JumpList.pas Vcl.JumpList.hpp	Vcl.JumpList	Vcl.JumpList

Beschreibung

Komponente, die die Unterstützung für Windows-Sprunglisten bereitstellt.

Windows-Sprunglisten wurden in Windows 7 eingeführt. Um TJumpList zu verwenden, muss Ihre Anwendung unter Windows 7 oder später ausgeführt werden. Wenn TCustomJumpList auf einer Version von Windows ausgeführt wird, die keine Sprunglisten unterstützt, erhält TCustomJumpList.Enabled den Wert False.

Hinweis: Enabled ist standardmäßig False. Sie müssen den Wert von Enabled auf True setzen, damit Ihre Sprungliste funktionieren kann.

Mit TJumpList können Sie zur Entwurfszeit eine Liste mit Aufgaben, die Verknüpfungen zu Funktionen Ihrer Anwendung bereitstellen, und eine beliebige Anzahl von benutzerdefinierten Kategorien mit benutzerdefinierten Einträgen definieren. Nach dem Festlegen Ihrer Aufgaben sowie der benutzerdefinierten Kategorien und Einträge, müssen Sie UpdateList aufrufen, damit Ihre Änderungen in der Sprungliste Ihrer Anwendung angezeigt werden. Alternativ können Sie auch die Eigenschaft AutoRefresh Ihrer Sprunglisten-Komponente aktivieren, wenn Ihre Änderungen sofort bei der Ausführung Ihrer Anwendung und nach jeder vorgenommenen Änderung zur Laufzeit angezeigt werden sollen.

Hinweis: Windows zeigt keine leeren Listen an.

Benutzer können Aufgaben und benutzerdefinierte Einträge aus der Liste mit den Aufgaben und benutzerdefinierten Einträgen, die in Ihrer Anwendung festgelegt sind, entfernen. Beim Aufruf rufen Methoden, wie UpdateList, eine Liste der Einträge ab, die Ihr Benutzer aus der Sprungliste Ihrer Anwendung entfernt hat. In einer Behandlungsroutine für das Ereignis OnItemDeleted können Sie diese Dateien nachverfolgen und aus Ihrer Sprunglisten-Komponente entfernen. Natürlich könnten Sie diese Einträge der Sprungliste wieder hinzufügen, aber Programmierer sollten die Auswahl des Benutzers respektieren.

Zusätzlich zu den Entwurfseigenschaften können Sie zur Laufzeit mit den folgenden Methoden Ihre Aufgaben und benutzerdefinierten Kategorien verwalten:

• AddTask und AddTaskSeparator.
• AddCategory und AddItemToCategory.

Ihre Sprunglisten-Komponente stellt ein Ereignis, OnItemsLoaded, bereit, das ausgelöst wird, wenn die Komponente das Laden beendet. Wenn Sie alle Ihre Aufgaben oder benutzerdefinierten Kategorien zur Laufzeit und nicht zur Entwurfszeit definieren möchten, ist dies der früheste Zeitpunkt, zu dem Sie ihre ursprünglichen Werte im Ausführungsfluss Ihrer Anwendung definieren können.

Mit Sprunglisten können Sie auch Dateien anzeigen, die der Benutzer früher mit Ihrer Anwendung geöffnet hat. Sie können entweder kürzlich verwendete Dateien, häufig verwendete Dateien oder sowohl kürzlich als auch häufig verwendete Dateien anzeigen. Obwohl das Anzeigen von sowohl kürzlich als auch häufig verwendeten Dateien möglich ist, empfiehlt Microsoft, dass Sie nur eine dieser Kategorien in jeder Anwendung verwenden.

Windows speichert diese Listen der Dateien, die Sie mit GetRecentList oder GetFrequentList abfragen können. Die Liste der kürzlich und häufig verwendeten Dateien enthält Dateien, die Ihr Benutzer manuell öffnet oder die Ihr Benutzer in Ihrer Anwendung mit TOpenDialog öffnet. Sie können diese Listen auch zur Laufzeit mit den folgenden Methoden ändern: AddToRecent, RemoveFromRecent, RemoveAllFromRecent. Diese Methoden wirken sich auf beide Listen aus. Dies bedeutet, dass beim Hinzufügen oder Entfernen eines Dateieintrags der Dateieintrag sowohl zur Liste mit kürzlich verwendeten Dateien als auch zur Liste mit häufig verwendeten Dateien hinzugefügt oder aus beiden Listen entfernt wird. Es ist nicht möglich, Dateieinträge nur zu einer Liste hinzuzufügen oder nur aus einer Liste zu entfernen.

Hinweis: Kürzlich und häufig verwendete Dateien sind in Anwendungen standardmäßig deaktiviert. Damit in Ihrer Anwendung eine Sprungliste angezeigt wird, muss Ihre Anwendung eine der folgenden Voraussetzungen erfüllen:

• Der Benutzer muss zuerst mindestens eine Datei in Ihrer Anwendung geöffnet haben.
• Sie müssen Ihre Anwendung als Dateihandler für eine oder mehrere Dateitypen im System registrieren.

Wenn Ihre Anwendung aus mehreren Prozessen besteht, können Sie anhand der Eigenschaft ApplicationID eine allgemeine Sprungliste für alle Prozesse Ihrer Anwendung erstellen. Wenn Ihre Anwendung bereits Anwendungsbenutzermodell-IDs verwendet, geben Sie in ApplicationID die ID Ihrer Anwendung ein.

Wenn mehrere Instanzen Ihrer Anwendung gleichzeitig ausgeführt werden können, müssen Sie einen Mechanismus implementieren, der verhindert, dass zwei Instanzen die Sprungliste der Anwendung gleichzeitig ändern. Änderungen der Sprungliste durch eine Instanz Ihrer Anwendung können Änderungen der Sprungliste durch eine andere Instanz Ihrer Anwendung überschreiben.

Siehe auch

• Jump Lists (Windows-Dokumentation)
• VCL-Taskleisten
• JumpListTest (Delphi)