Vcl.JumpList.TCustomJumpList.AddCategory
Delphi
function AddCategory(const CategoryName: string): Integer;
C++
int __fastcall AddCategory(const System::UnicodeString CategoryName);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | Vcl.JumpList.pas Vcl.JumpList.hpp |
Vcl.JumpList | TCustomJumpList |
Description
Ajoute une catégorie à la liste des catégories personnalisées avec le nom de catégorie spécifié, et renvoie l'index de la nouvelle catégorie de la liste.
AddCategory vous permet d'ajouter des catégories à votre liste à l'exécution. Utilisez la propriété CustomCategories pour définir vos catégories à la conception.
AddCategory définit la propriété Visible de la nouvelle catégorie sur True.
Windows affiche uniquement les catégories comportant des éléments. Après l'appel à AddCategory, n'oubliez pas d'ajouter au moins un élément à votre liste, puis d'actualiser la liste si vous n'avez pas activé AutoRefresh :
Delphi :
CategoryIndex := JumpLists1.AddCategory('MyCategory');
JumpLists1.AddItemToCategory(CategoryIndex, 'MyItem', '', '', '');
JumpLists1.UpdateList;
int CategoryIndex = JumpLists1->AddCategory("MyCategory");
JumpLists1->AddItemToCategory(CategoryIndex, "MyItem", "", "", "");
JumpLists1->UpdateList();
Le résultat est le suivant :
Vous pouvez aussi spécifier une chaîne vide en tant que nom de la catégorie. Le résultat est le suivant :
Voir aussi
- Vcl.JumpList.TJumpCategoryItem
- Vcl.JumpList.TJumpCategoryItem.CategoryName
- System.Classes.TCollectionItem.Index
- Vcl.JumpList.TJumpCategoryItem.Visible