Vcl.JumpList.TCustomJumpList.UpdateList

• Übergeordnet: TCustomJumpList

Delphi

function UpdateList: Boolean;

C++

bool __fastcall UpdateList();

Eigenschaften

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

Beschreibung

Aktualisiert die Sprungliste Ihrer Anwendung, um die in Ihrer Sprunglisten-Komponente festgelegten Informationen zu aktualisieren.

UpdateList gibt True zurück, wenn die Aktualisierung erfolgreich war, ansonsten False.

Alternativ können Sie die Eigenschaft AutoRefresh aktivieren, damit alle Änderungen an der Sprunglisten-Komponente mit der Sprungliste Ihrer Anwendung synchronisiert werden.

Exceptions

Der Aufruf von UpdateList könnte eine der folgenden Exceptions auslösen:

Exception	Exception.Message	Szenarien
EJumpListException	JumpList-Exception: Fehler <Code> Liste wird begonnen	ICustomDestinationList::BeginList hat einen Fehlercode zurückgegeben, und Sie haben entweder das Ereignis OnListUpdateError nicht behandelt, oder Ihre Ereignisbehandlungsroutine hat den Fehler nicht als behandelt gekennzeichnet.
	JumpList-Exception: Fehler <Code> Liste wird übergeben	ICustomDestinationList::CommitList hat einen Fehlercode zurückgegeben, und Sie haben entweder das Ereignis OnListUpdateError nicht behandelt, oder Ihre Ereignisbehandlungsroutine hat den Fehler nicht als behandelt gekennzeichnet.
EJumpListItemException	JumpListItem-Exception: Fehler <Code> Kategorie "Kürzlich" wird angehängt	ShowRecent ist True, und ICustomDestinationList::AppendKnownCategory hat einen Fehlercode zurückgegeben.
	JumpListItem-Exception: Fehler <Code> Kategorie "Häufig" wird angehängt	ShowFrequent ist True, und ICustomDestinationList::AppendKnownCategory hat einen Fehlercode zurückgegeben.
	JumpListItem-Exception: Fehler <Code> Benutzeraufgaben werden hinzugefügt	Sie haben eine oder mehrere Aufgaben definiert, und beim Hinzufügen einer dieser Aufgaben zur Sprungliste Ihrer Anwendung hat ICustomDestinationList::AddUserTasks einen Fehlercode zurückgegeben.
	JumpListItem-Exception: Fehler <Code> Kategorie <Name> wird hinzugefügt	Sie haben eine oder mehrere eigene Kategorien definiert, und beim Hinzufügen einer dieser Kategorien zur Sprungliste Ihrer Anwendung hat ICustomDestinationList::AppendCategory einen Fehlercode zurückgegeben.

Die Implementierung von UpdateList verwendet die folgenden Member, die eigene Exceptions auslösen können:

• GetObjectArray
• GetAsIShellLink

Siehe auch

• System.Boolean

• Vcl.JumpList.TCustomJumpList.DeleteList

• Vcl.JumpList.TCustomJumpList.TaskList
• Vcl.JumpList.TCustomJumpList.CustomCategories
• Vcl.JumpList.TCustomJumpList.AutoRefresh

• Vcl.JumpList.TCustomJumpList.ShowFrequent
• Vcl.JumpList.TCustomJumpList.ShowRecent

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