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 */;
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
procedure function |
public | Vcl.JumpList.pas Vcl.JumpList.hpp |
Vcl.JumpList | TCustomJumpList |
Description
Ajoute le fichier spécifié à la liste des fichiers ayant été utilisés récemment par votre application et à la liste des fichiers utilisés fréquemment par l'application.
Le fichier cible peut être spécifié sous l'une des formes suivantes :
- Une chaîne contenant un chemin d'accès à un fichier. Par exemple : "C:\Users\User\Documents\MyDocument.txt".
- Une instance de TJumpListItem.
- Une instance d'une classe qui implémente l'interface IShellLink.
Windows affiche uniquement des listes de fichiers récents ou fréquents si votre application est configurée pour ouvrir un ou plusieurs types de fichiers. Supposons, par exemple, que votre utilisateur sélectionne votre application comme application valide pour l'ouverture d'un type de fichier particulier. Même si votre application n'est pas l'application par défaut pour l'ouverture de ce type de fichier, les fichiers récents et fréquents apparaîtront sur la barre des tâches de l'application. Une fois que votre application a été configurée comme étant capable d'ouvrir un ou plusieurs types de fichiers, vous pouvez ajouter des fichiers de tout type à la liste des fichiers récents et fréquents de votre application.
Par défaut, Windows affiche uniquement la liste des fichiers récents. Pour afficher la liste des fichiers fréquents à la place, activez la propriété ShowFrequent. Microsoft recommande de n'afficher que l'une de ces listes. Toutefois, vous pouvez afficher les deux listes si vous le souhaitez. Pour afficher les deux listes, activez à la fois les propriétés ShowRecent et ShowFrequent.
Quand votre application ouvre un fichier utilisant le composant TOpenDialog, le fichier ouvert est automatiquement ajouté à la liste des fichiers récents et fréquents. Vous n'avez pas besoin d'appeler manuellement AddToRecent pour enregistrer les fichiers que votre utilisateur ouvre utilisant TOpenDialog.
Exceptions
AddToRecent appelle GetAsIShellLink sur JumpItem. GetAsIShellLink peut déclencher certaines exceptions.