Vcl.JumpList.TCustomJumpList.DeleteList

• Übergeordnet: TCustomJumpList

Delphi

function DeleteList: Boolean;

C++

bool __fastcall DeleteList();

Eigenschaften

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

Beschreibung

Entfernt den Inhalt, der Ihre Anwendung für ihre Sprungliste definiert hat, und gibt True zurück, wenn das Entfernen erfolgreich ist, ansonsten False.

DeleteList entfernt aus der Sprungliste Ihrer Anwendung jede Konfiguration , die Ihre Anwendung mit der Sprunglisten-Komponente definiert hat. Zu diesen zählen:

• Ihre benutzerdefinierten Kategorien und Kategorieeinträge.
• Ihre Aufgaben.
• Die Konfiguration zum Ein- oder Ausblenden von zuletzt verwendeten und häufig verwendeten Dateien. Wenn die beiden Listen beispielsweise ausgeblendet sind, stellt DeleteList das Windows-Standardverhalten des Anzeigens der zuletzt verwendeten Dateien Ihrer Anwendung wieder her.

Hinweis: DeleteList entfernt keine Daten aus der Sprunglisten-Komponente. Daten werden nur aus der tatsächlichen Sprungliste entfernt. Wenn Sie UpdateList unmittelbar nach dem Aufruf von DeleteList aufrufen, hat die Kombination der beiden Aufrufe keine Auswirkung.

Exceptions

Durch Aufrufen von DeleteList kann eine der folgenden Exceptions ausgelöst werden:

Exception	Exception.Message	Szenarien
EJumpListException	JumpList-Exception: Fehler <Code> Liste wird begonnen	ICustomDestinationList::BeginList hat einen Fehlercode zurückgegeben und Sie haben das OnListUpdateError-Ereignis nicht behandelt oder Ihre Ereignisbehandlungsroutine hat den Fehler nicht als behandelt markiert.
	JumpList-Exception: Fehler <Code> Liste wird übergeben	ICustomDestinationList::CommitList hat einen Fehlercode zurückgegeben und Sie haben das OnListUpdateError-Ereignis nicht behandelt oder Ihre Ereignisbehandlungsroutine hat den Fehler nicht als behandelt markiert.

Siehe auch

• Vcl.JumpList.TCustomJumpList.CustomCategories
• Vcl.JumpList.TCustomJumpList.TaskList
• Vcl.JumpList.TCustomJumpList.ShowRecent
• Vcl.JumpList.TCustomJumpList.ShowFrequent

• Vcl.JumpList.TCustomJumpList.UpdateList
• Vcl.JumpList.TCustomJumpList.Enabled

• Vcl.JumpList.TCustomJumpList.OnItemDeleted
• Vcl.JumpList.TCustomJumpList.OnListUpdateError