Vcl.JumpList.TCustomJumpList.UpdateList

• Aller au parent : TCustomJumpList

Delphi

function UpdateList: Boolean;

C++

bool __fastcall UpdateList();

Propriétés

Type	Visibilité	Source	Unité	Parent
function	public	Vcl.JumpList.pas Vcl.JumpList.hpp	Vcl.JumpList	TCustomJumpList

Description

Met à jour la liste de raccourcis de votre application pour afficher les informations définies dans votre composant Liste de raccourcis.

UpdateList renvoie True si la mise à jour réussit ou False dans le cas contraire.

Alternativement, vous pouvez activer la propriété AutoRefresh pour que les modifications apportées au composant Liste de raccourcis soient synchronisées avec la liste de raccourcis de votre application.

Exceptions

Un appel à UpdateList peut déclencher l'une des exceptions suivantes :

Exception	Exception.Message	Scénarios
EJumpListException	Exception JumpList : Erreur <code> Démarrage de la liste	ICustomDestinationList::BeginList a renvoyé un code d'erreur : il est possible que vous n'ayez pas géré l'événement OnListUpdateError ou que votre gestionnaire d'événement n'ait pas considéré l'erreur comme étant gérée.
	Exception JumpList : Erreur <code> Validation de la liste	ICustomDestinationList::CommitList a renvoyé un code d'erreur : il est possible que vous n'ayez pas géré l'événement OnListUpdateError ou que votre gestionnaire d'événement n'ait pas considéré l'erreur comme étant gérée.
EJumpListItemException	Exception JumpListItem : Erreur <code> Ajout de la catégorie Récents	ShowRecent vaut True et ICustomDestinationList::AppendKnownCategory a renvoyé un code d'erreur.
	Exception JumpListItem : Erreur <code> Ajout de la catégorie Fréquents	ShowFrequent vaut True et ICustomDestinationList::AppendKnownCategory a renvoyé un code d'erreur.
	Exception JumpListItem : Erreur <code> Ajout des tâches utilisateur	Vous avez défini une ou plusieurs tâches et, l'ajout de l'une de ces tâches à la liste des raccourcis de votre application, ICustomDestinationList::AddUserTasks a renvoyé un code d'erreur.
	Exception JumpListItem : Erreur <code> Ajout de la catégorie <nom>	Vous avez défini une ou plusieurs catégories personnalisées et, l'ajout de l'une de ces tâches à la liste des raccourcis de votre application, ICustomDestinationList::AppendCategory a renvoyé un code d'erreur.

L'implémentation de UpdateList utilise les membres suivants, susceptibles de déclencher leurs propres exceptions :

• GetObjectArray
• GetAsIShellLink

Voir aussi

• System.Boolean

• Vcl.JumpList.TCustomJumpList.DeleteList

• Vcl.JumpList.TCustomJumpList.TaskList
• Vcl.JumpList.TCustomJumpList.CustomCategories
• Vcl.JumpList.TCustomJumpList.AutoRefresh

• Vcl.JumpList.TCustomJumpList.ShowFrequent
• Vcl.JumpList.TCustomJumpList.ShowRecent

• Vcl.JumpList.TCustomJumpList.OnItemDeleted
• Vcl.JumpList.TCustomJumpList.OnListUpdateError