通过

Event.Persistable 属性 (Visio)

  • 项目

确定事件能否在其文档中具有永久性。 此为只读属性。

语法

expression。 Persistable

表达 一个代表 Event 对象的变量。

返回值

整数

备注

Event 对象的 Persistable 属性指示事件能否具有永久性，即 Event 对象在程序执行期间是否可以与 Microsoft Visio 文档一起存储。 如果满足下列条件，则 Event 对象可以具有永久性：

  1. Event 对象的动作代码必须是 visActCodeRunAddon。 如果动作代码是 visActCodeAdvise，该事件将不具有永久性而且必须在运行时由程序重新创建。

  2. 源对象必须能够在其 EventList 集合中包含永久事件。 源对象的 PersistsEvents 属性指示它能否包含永久事件。 当前可以包含永久事件的源对象只有 Document、Master 和 Page 对象。

如果满足下列条件，下列任何事件都具有永久性：

  • BeforeMasterDelete

  • BeforePageDelete

  • BeforeShapeDelete

  • DocumentOpened

  • DocumentCreated

  • MasterAdded

  • PageAdded

尽管 Event 对象的 Persistable 属性指示事件能否具有永久性，但是其 Persistent 属性指示事件实际上是否具有永久性。 第一次创建 Event 对象时，它的 Persistent 属性与其 Persistable 属性将设置为相同的值。 也就是说，永久事件的 Persistent 属性设置为 True，而非永久事件的 Persistent 属性设置为 False。

只要在 Event 对象、包含 Event 对象的 EventList 对象或者具有 EventList 对象的源对象上保留引用，就会存在非永久事件。 如果释放对所有这些对象的最后一次引用，非永久事件将不再存在。

您可以通过将永久事件的 Persistent 属性设置为 False 来更改其初始设置。 在这种情况下，此事件在其文档中不具有永久性，即使它本身可以具有永久性也是如此。 不过，您不能更改非永久事件的 Persistent 属性；试图这样做将会引发异常。

注意

在 Microsoft Visual Basic for Applications (VBA) 项目中处理的事件是永久的。

支持和反馈

有关于 Office VBA 或本文档的疑问或反馈？ 请参阅 Office VBA 支持和反馈，获取有关如何接收支持和提供反馈的指南。