Vcl.JumpList.TJumpList.OnListUpdateError
Delphi
property OnListUpdateError: TCreatingListErrorEvent read FOnListUpdateError write FOnListUpdateError;
C++
__property OnListUpdateError;
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
event | published | Vcl.JumpList.pas Vcl.JumpList.hpp |
Vcl.JumpList | TJumpList |
Beschreibung
Wird ausgelöst, wenn ein Fehler bei der Aktualisierung der Sprungliste Ihrer Anwendung auftritt.
Vcl.JumpList.TJumpList.OnListUpdateError erbt von Vcl.JumpList.TCustomJumpList.OnListUpdateError. Der folgende Inhalt bezieht sich auf Vcl.JumpList.TCustomJumpList.OnListUpdateError.
Wird ausgelöst, wenn ein Fehler bei der Aktualisierung der Sprungliste Ihrer Anwendung auftritt.
Ihre Sprunglisten-Komponente aktualisiert die Sprungliste Ihrer Anwendung, wenn:
- Ihr Formular Ihre Sprunglisten-Komponente lädt.
- Sie DeleteList oder UpdateList aufrufen.
- Sie die Eigenschaft AutoRefresh auf
True
setzen. - AutoRefresh aktiviert ist und Sie den Wert von CustomCategories, ShowFrequent, ShowRecent oder TasksList ändern.
Mit dem Ereignis OnListUpdateError können Sie den Fehler selbst behandeln, die Fehlerinformationen prüfen und entscheiden, ob der Fehler eine Exception auslösen sollte oder nicht.
Die Ereignisbehandlungsroutine von OnListUpdateError empfängt die folgenden Parameter:
Sender
ist Ihre Sprunglisten-Komponente.WinErrorCode
ist der Code des Fehlers, der in der Windows-Sprunglisten-API definiert ist.ErrorDescription
ist eine lesbare Beschreibung des Fehlers.Handled
legt fest, ob der Fehler eine Exception auslösen sollte oder nicht. Um eine Exception auszulösen, setzen SieHandled
aufFalse
. Ansonsten, setzen SieHandled
aufTrue
.