Vcl.JumpList.TCustomJumpList.OnListUpdateError
Delphi
property OnListUpdateError: TCreatingListErrorEvent read FOnListUpdateError write FOnListUpdateError;
C++
__property TCreatingListErrorEvent OnListUpdateError = {read=FOnListUpdateError, write=FOnListUpdateError};
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
event | public | Vcl.JumpList.pas Vcl.JumpList.hpp |
Vcl.JumpList | TCustomJumpList |
Description
Se produit lorsqu'il y a une erreur à l'actualisation de la liste des raccourcis de votre application.
Votre composant Liste des raccourcis actualise la liste des raccourcis de votre application quand :
- Votre fiche charge votre composant Liste des raccourcis.
- Vous appelez DeleteList ou UpdateList.
- Vous définissez la propriété AutoRefresh sur
True
. - Vous devez avoir AutoRefresh activé, et changez la valeur de CustomCategories, ShowFrequent, ShowRecent ou TasksList.
L'événement OnListUpdateError vous permet de gérer votre erreur vous-même, de vérifier les informations sur l'erreur, et de décider si l'erreur doit déclencher une exception ou non.
Le gestionnaire d'événement de OnListUpdateError reçoit les paramètres suivants :
Sender
est le composant de votre Liste des raccourcis.WinErrorCode
est le code d'erreur tel qu'il est défini par Windows Jump Lists API.ErrorDescription
est une description parlante de l'erreur.Handled
détermine si l'erreur doit déclencher une exception ou non. Pour déclencher une exception, définissezHandled
surFalse
; sinon, définissezHandled
surTrue
.