Vcl.JumpList.TCustomJumpList.AddItemToCategory

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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());

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
Vcl.JumpList.pas
Vcl.JumpList.hpp
Vcl.JumpList TCustomJumpList


Beschreibung

Fügt einen Listeneintrag zu der Kategorie mit dem angegebenen Index hinzu und gibt den neuen Listeneintrag zurück.

AddItemToCategory ermöglicht zur Laufzeit das Hinzufügen von Listeneinträgen zu Kategorien. Mit der Eigenschaft Items einer Kategorie können Sie zur Entwurfszeit Ihre Listeneinträge festlegen.

CategoryIndex ist der Index der Zielkategorie. Mit den verbleibenden Parametern können Sie die Eigenschaften Ihres neuen Listeneintrags festlegen:

Parameter Eigenschaft Hinweise

FriendlyName

FriendlyName

  • Darf kein leerer String sein.

Path

Path

Arguments

Arguments

Icon

Icon

AddItemToCategory setzt die Eigenschaft Visible des neuen Listeneintrags auf True. Neue Listeneinträge sind standardmäßig keine Trennlinien.

Nach dem Aufruf von AddItemToCategory müssen Sie die Sprungliste aktualisieren, wenn Sie AutoRefresh nicht aktiviert haben:

Delphi:

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

Ergebnis:

JumpListsMyCategoryMyItem.png

Siehe auch