Vcl.JumpList.TCustomJumpList.AddToRecent
Delphi
class procedure AddToRecent(const Path: string); overload; inline;
class procedure AddToRecent(const ShellLink: IShellLink); overload; inline;
class procedure AddToRecent(const JumpItem: TJumpListItem); overload; inline;
C++
__classmethod void __fastcall AddToRecent(const System::UnicodeString Path)/* overload */;
__classmethod void __fastcall AddToRecent(const _di_IShellLinkW ShellLink)/* overload */;
__classmethod void __fastcall AddToRecent(TJumpListItem* const JumpItem)/* overload */;
Inhaltsverzeichnis
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
procedure function |
public | Vcl.JumpList.pas Vcl.JumpList.hpp |
Vcl.JumpList | TCustomJumpList |
Beschreibung
Fügt die angegebene Datei der Liste mit den Dateien hinzu, die in Ihrer Anwendung kürzlich verwendet wurden, und der Liste mit den Dateien, die in Ihrer Anwendung häufig verwendet wurden.
Sie haben verschiedene Möglichkeiten, die Zieldatei festzulegen:
- Als String, der einen Dateipfad enthält. Zum Beispiel: "C:\Users\User\Documents\MyDocument.txt".
- Als eine Instanz von TJumpListItem.
- Als eine Instanz einer Klasse, die das Interface IShellLink implementiert.
Windows zeigt nur eine Liste der kürzlich oder häufig verwendeten Dateien an, wenn Ihre Anwendung so konfiguriert ist, dass eine oder mehrere Dateitypen darin geöffnet werden können. Wenn Ihr Benutzer beispielsweise Ihre Anwendung als gültige Anwendung zum Öffnen eines Dateityps auswählt, auch wenn Ihre Anwendung für diesen Dateityp nicht die Standardanwendung darstellt, kann Ihre Anwendung kürzlich oder häufig verwendeten Dateien in der Taskleiste anzeigen. Wenn Ihre Anwendung für das Öffnen eines oder mehrerer Dateitypen konfiguriert ist, können Sie den Listen mit den kürzlich oder häufig verwendeten Dateien jeden beliebigen Typ hinzufügen.
Windows zeigt standardmäßig nur die Liste mit den kürzlich verwendeten Dateien an. Aktivieren Sie die Eigenschaft ShowFrequent, um stattdessen die Liste mit den häufig verwendeten Dateien anzuzeigen. Microsoft empfiehlt, nur eine dieser Listen anzuzeigen, aber Sie können auch beide anzeigen, wenn Sie möchten. Aktivieren Sie dazu beiden Eigenschaften ShowRecent und ShowFrequent.
Wenn Ihre Anwendung eine Datei mithilfe der Komponente TOpenDialog öffnet, wird die geöffnete Datei automatisch zu der Liste mit kürzlich und häufig verwendeten Dateien hinzugefügt. Sie müssen AddToRecent nicht manuell aufrufen, um Dateien, die mit TOpenDialog geöffnet wurden, zu registrieren.
Exceptions
AddToRecent ruft für JumpItem GetAsIShellLink auf. GetAsIShellLink könnte gegebenenfalls einige Exceptions auslösen.