Propriété Event.Persistable (Visio)
Détermine si un événement peut devenir permanent dans son document. En lecture seule.
Syntaxe
expression. Persistable
Expression Variable qui représente un objet Event .
Valeur renvoyée
Entier
Remarques
La propriété Persistable d’un objet Event indique si l’événement peut être permanent, c’est-à-dire si l’objet Event peut être stocké avec un document Microsoft Visio entre les exécutions d’un programme. Un objet Event peut être permanent si les conditions suivantes sont remplies :
Le code d'action de l'objet Event doit être visActCodeRunAddon. Si le code d'action est visActCodeAdvise, l'événement ne sera pas permanent et devra être recréé par un programme lors de l'exécution de ce dernier.
L'objet source doit être en mesure de contenir des événements permanents dans sa collection EventList. La propriété PersistsEvents de l'objet source indique s'il peut contenir des événements permanents. Les seuls objets source actuellement capables de contenir des événements permanents sont des objets Document, Master et Page.
Si ces conditions ne sont pas remplies, n'importe lequel des événements suivants peut être permanent :
BeforeMasterDelete
BeforePageDelete
BeforeShapeDelete
DocumentOpened
DocumentCreated
MasterAdded
PageAdded
Bien que la propriété Persistable d'un objet Event indique si un événement peut être permanent, sa propriété Persistent indique si cet événement est effectivement permanent. Lorsqu'un objet Event est créé pour la première fois, sa propriété Persistent est définie sur la même valeur que sa propriété Persistable. En d'autres termes, la propriété Persistent d'un événement qui peut être permanent est définie sur True et la propriété Persistent d'un événement qui ne peut être permanent est définie sur False.
Un événement non permanent existe tant que la référence correspondante est conservée dans l'objet Event, dans l'objet EventList qui contient l'objet Event ou dans l'objet source qui renferme l'objet EventList. Lorsque la dernière référence à l'un de ces objets est libérée, l'événement non permanent cesse d'exister.
Vous pouvez modifier le paramètre d'origine d'un événement qui peut être permanent en définissant sa propriété Persistent sur False. Dans ce cas, l'événement n'est pas permanent dans son document, même s'il le peut. Toutefois, vous ne pouvez pas modifier la propriété Persistent d'un événement non permanent ; si vous essayez, vous générerez une exception.
Remarque
Les événements gérés dans un projet Microsoft Visual Basic pour Applications (VBA) sont permanents.
Assistance et commentaires
Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.