Vcl.JumpList.TCustomJumpList.AddItemToCategory

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function AddItemToCategory(CategoryIndex: Integer; const FriendlyName: string; const Path: string = '';  const Arguments: string = ''; const Icon: string = ''): TJumpListItem;

C++

TJumpListItem* __fastcall AddItemToCategory(int CategoryIndex, const System::UnicodeString FriendlyName, const System::UnicodeString Path = System::UnicodeString(), const System::UnicodeString Arguments = System::UnicodeString(), const System::UnicodeString Icon = System::UnicodeString());

Propriétés

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


Description

Ajoute un élément de la liste à la catégorie avec l'index spécifié, et renvoie votre nouvel élément de la liste.

AddItemToCategory vous permet d'ajouter des éléments de la liste aux catégories à l'exécution. Utilisez la propriété Items d'une catégorie pour définir vos éléments de la liste à la conception.

CategoryIndex est l'index de la catégorie cible. Utilisez les paramètres restants pour définir les propriétés de votre nouvel élément de la liste :

Paramètre Propriété Remarques

FriendlyName

FriendlyName

  • Doit être une chaîne non vide.

Path

Path

Arguments

Arguments

Icon

Icon

AddItemToCategory définit la propriété Visible du nouvel élément de la liste sur True. De plus, les nouveaux éléments de la liste ne sont pas des séparateurs par défaut.

Après l'appel à AddItemToCategory, n'oubliez pas d'actualiser les listes de raccourcis si vous n'avez pas activé AutoRefresh :

Delphi :

JumpLists1.AddItemToCategory(CategoryIndex, 'MyItem');
JumpLists1.UpdateList;
C++ :
JumpLists1->AddItemToCategory(CategoryIndex, "MyItem");
JumpLists1->UpdateList();

Le résultat est le suivant :

JumpListsMyCategoryMyItem.png

Voir aussi