Vcl.JumpList.TCustomJumpList.CustomCategories

• Aller au parent : TCustomJumpList

Delphi

property CustomCategories: TJumpCategories read FCustomCategories write SetCustomCategories;

C++

__property TJumpCategories* CustomCategories = {read=FCustomCategories, write=SetCustomCategories};

Propriétés

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

Description

Liste des catégories personnalisées à afficher sur la liste de raccourcis de vos applications.

Outre une liste des fichiers récents, une liste des fichiers fréquents et une liste des tâches, votre application peut définir des listes personnalisées avec des éléments personnalisés. Utilisez la propriété CustomCategories pour définir ces listes personnalisées.

Pour définir des catégories à l'exécution, utilisez la méthode AddCategory.

Les catégories sont affichées uniquement quand elles comportent au moins un élément. Vous pouvez ajouter des éléments à vos catégories personnalisées à la conception en utilisant leur propriété Items, ou à l'exécution en utilisant la méthode AddItemToCategory.

Exceptions

La modification du contenu de la propriété CustomCategories peut déclencher l'une des exceptions suivantes :

Exception	Exception.Message	Scénarios
EJumpListException	Exception JumpList : Erreur <code> Démarrage de la liste	AutoRefresh vaut True, pendant la mise à jour ICustomDestinationList::BeginList a renvoyé un code d'erreur, et vous n'avez pas géré l'événement OnListUpdateError ou votre gestionnaire d'événement n'a pas marqué l'erreur comme gérée.
	Exception JumpList : Erreur <code> Validation de la liste	AutoRefresh vaut True, pendant la mise à jour ICustomDestinationList::CommitList a renvoyé un code d'erreur, et vous n'avez pas géré l'événement OnListUpdateError ou votre gestionnaire d'événement n'a pas marqué l'erreur comme gérée.

Si AutoRefresh vaut True et que vous modifiez le contenu de la propriété CustomCategories, le composant de votre liste de raccourcis utilise les membres suivants qui peuvent déclencher leurs propres exceptions :

• UpdateList
• GetObjectArray
• GetAsIShellLink

Voir aussi

• Vcl.JumpList.TJumpCategories
• Vcl.JumpList.TJumpCategoryItem

• Vcl.JumpList.TCustomJumpList.AddCategory

• Vcl.JumpList.TJumpCategoryItem.Items
• Vcl.JumpList.TCustomJumpList.AddItemToCategory

• Vcl.JumpList.TCustomJumpList.GetRecentList
• Vcl.JumpList.TCustomJumpList.GetFrequentList
• Vcl.JumpList.TCustomJumpList.TaskList

• Vcl.JumpList.TCustomJumpList.AutoRefresh
• Vcl.JumpList.TCustomJumpList.DeleteList
• Vcl.JumpList.TCustomJumpList.UpdateList

• Vcl.JumpList.TCustomJumpList.OnItemDeleted
• Vcl.JumpList.TCustomJumpList.OnItemsLoaded