Vcl.JumpList.TCustomJumpList.AddCategory

• Übergeordnet: TCustomJumpList

Delphi

function AddCategory(const CategoryName: string): Integer;

C++

int __fastcall AddCategory(const System::UnicodeString CategoryName);

Eigenschaften

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

Beschreibung

Fügt der Liste mit benutzerdefinierten Kategorien eine Kategorie mit dem angegebenen Kategorienamen hinzu und gibt den Index der neuen Kategorie in der Liste zurück.

AddCategory ermöglicht zur Laufzeit das Hinzufügen von Kategorien zu der Liste. Mit der Eigenschaft CustomCategories können Sie zur Entwurfszeit Ihre Kategorien festlegenn.

AddCategory setzt die Eigenschaft Visible der neuen Kategorie auf True.

Windows zeigt nur Kategorien mit Einträge an. Nach dem Aufruf von AddCategory müssen Sie Ihrer Liste mindestens einen Eintrag hinzufügen und dann die Liste aktualisieren, wenn Sie AutoRefresh nicht aktiviert haben:

Delphi:

CategoryIndex := JumpLists1.AddCategory('MyCategory');
JumpLists1.AddItemToCategory(CategoryIndex, 'MyItem', '', '', '');
JumpLists1.UpdateList;

C++:

int CategoryIndex = JumpLists1->AddCategory("MyCategory");
JumpLists1->AddItemToCategory(CategoryIndex, "MyItem", "", "", "");
JumpLists1->UpdateList();

Ergebnis:

Sie können auch einen leeren String als Kategorienamen angeben. Ergebnis:

Siehe auch

• System.String
• System.Integer

• Vcl.JumpList.TCustomJumpList.CustomCategories
• System.Classes.TCollection.Add

• Vcl.JumpList.TJumpCategoryItem
• Vcl.JumpList.TJumpCategoryItem.CategoryName
• System.Classes.TCollectionItem.Index
• Vcl.JumpList.TJumpCategoryItem.Visible

• Vcl.JumpList.TCustomJumpList.AddItemToCategory
• Vcl.JumpList.TCustomJumpList.AutoRefresh
• Vcl.JumpList.TCustomJumpList.UpdateList

• Vcl.JumpList.TCustomJumpList.AddTask
• Vcl.JumpList.TCustomJumpList.AddTaskSeparator
• Vcl.JumpList.TCustomJumpList.AddToRecent