Event.Persistable-Eigenschaft (Visio)

  • Artikel

Bestimmt, ob ein Ereignis in seinem Dokument potentiell dauerhaft sein kann. Schreibgeschützt.

Syntax

Ausdruck. Persistable

Ausdruck Eine Variable, die ein Event-Objekt darstellt.

Rückgabewert

Ganze Zahl

HinwBemerkungeneise

Die Persistable-Eigenschaft eines Event-Objekts gibt an, ob das Ereignis dauerhaft sein kann, d. h., ob das Event-Objekt in einem Microsoft Visio-Dokument zwischen den Ausführungen eines Programms gespeichert werden kann. Ein Event-Objekt kann dauerhaft sein, wenn die folgenden Bedingungen erfüllt sind:

  1. Der Aktionscode des Event-Objekts muss visActCodeRunAddon lauten. Wenn der Aktionscode visActCodeAdvise lautet, kann das Ereignis nicht dauerhaft sein und muss von einem Programm zur Laufzeit neu erstellt werden.

  2. Das Quellobjekt muss in seiner EventList-Auflistung dauerhafte Ereignisse enthalten können. Die PersistsEvents-Eigenschaft des Quellobjekts gibt an, ob es dauerhafte Ereignisse enthalten kann. Die gegenwärtig einzigen Quellobjekte, die dauerhafte Ereignisse enthalten können, sind Document-, Master- und Page-Objekte.

Wenn diese Bedingungen erfüllt sind, können alle folgenden Ereignisse dauerhaft sein:

  • BeforeMasterDelete

  • BeforePageDelete

  • BeforeShapeDelete

  • DocumentOpened

  • DocumentCreated

  • MasterAdded

  • PageAdded

Obwohl eine Persistable-Eigenschaft des Event-Objekts angibt, ob ein Ereignis dauerhaft sein kann, gibt dessen Persistent-Eigenschaft an, ob dieses Ereignis tatsächlich dauerhaft ist. Wenn ein Event-Objekt zuerst erstellt wird, wird dessen Persistent-Eigenschaft auf denselben Wert wie dessen Persistable-Eigenschaft festgelegt. Demnach wird die Persistent-Eigenschaft eines dauerhaften Ereignisses auf True und die Persistent-Eigenschaft eines nicht dauerhaften Ereignisses auf False festgelegt.

Ein nicht dauerhaftes Ereignis ist so lange vorhanden, solange auf das Event-Objekt, auf das EventList-Objekt, das das Event-Objekt enthält, oder das Quellobjekt, das das EventList-Objekt enthält, verwiesen wird. Wenn der letzte Verweis auf eines dieser Objekte aufgehoben wird, erlischt das nicht dauerhafte Ereignis.

Wenn Sie die Persistent-Eigenschaft eines dauerhaften Ereignisses auf False festlegen, können Sie dessen ursprüngliche Einstellung ändern. In diesem Fall bleibt das Ereignis nicht mit seinem Dokument bestehen, obwohl dies möglich wäre. Allerdings können Sie die Persistent-Eigenschaft eines nicht dauerhaften Ereignisses nicht ändern, ansonsten lösen Sie eine Ausnahme aus.

Hinweis

Die in einem VBA-Projekt (Microsoft Basic für Applikationen) behandelten Ereignisse sind dauerhaft.

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.