Compartilhar via


Propriedade Event.Persistable (Visio)

Determina se um evento pode persistir potencialmente dentro de seu documento. Somente leitura.

Sintaxe

expression. Persistable

Expressão Uma variável que representa um objeto Event .

Valor de retorno

Inteiro

Comentários

A propriedade Persistable de um objeto Event indica se o evento pode persistir, isto é, se o objeto Event pode ser armazenado com um documento do Microsoft Visio entre as execuções de um programa. Um objeto Event poderá persistir se as seguintes condições forem verdadeiras:

  1. O código de ação do objeto Event deve ser visActCodeRunAddon. Se o código de ação for visActCodeAdvise, o evento não persistirá e deverá ser recriado por um programa em tempo de execução.

  2. O objeto de origem deve ser capaz de conter eventos persistentes em sua coleção EventList. A propriedade PersistsEvents do objeto de origem indica se ele pode conter eventos persistentes. Os únicos objetos de origem atualmente capazes de conter eventos persistentes são os objetos Document, Master e Page.

Se essas condições forem atendidas, quaisquer dos seguintes eventos são persistentes:

  • BeforeMasterDelete

  • BeforePageDelete

  • BeforeShapeDelete

  • DocumentOpened

  • DocumentCreated

  • MasterAdded

  • PageAdded

Embora uma propriedade Persistable de um objeto Event indique se um evento pode persistir, sua propriedade Persistent indica se aquele evento realmente persiste. Quando um objeto Event é criado pela primeira vez, sua propriedade Persistent é definida para o mesmo valor de sua propriedade Persistable. Isto é, uma propriedade Persistent de um evento persistente é definida como True e uma propriedade Persistent de um evento não persistente é definida como False.

Um evento não persistente existe desde que uma referência seja mantida no objeto Event, o objeto EventList que contém o objeto Event ou o objeto de origem que possui o objeto EventList. Quando a última referência a quaisquer desses objetos é liberada, o evento não persistente deixa de existir.

Você pode alterar a configuração inicial para um evento persistente, definindo sua propriedade Persistent como False. Neste caso, o evento não persiste com seu documento, mesmo se pudesse. Entretanto, não é possível alterar a propriedade Persistent de um evento não persistente; tentar fazê-lo causará uma exceção.

Observação

Os eventos controlados em um projeto do Microsoft Visual Basic for Applications (VBA) são persistentes.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.