Compartilhar via


Evento Documents.DocumentCreated (Visio)

Ocorre após um documento ser criado.

Sintaxe

expressão. DocumentCreated (doc)

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

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
doc Obrigatório [IVDOCUMENT] O documento que foi criado.

Comentários

O evento DocumentCreated é muitas vezes adicionado à coleção EventList de um arquivo de modelo do Microsoft Visio (.vst). A ação do evento é disparada sempre que um documento novo é criado com base naquele modelo.

Se estiver usando o Microsoft Visual Basic ou o Visual Basic for Applications (VBA), a sintaxe deste tópico descreverá uma maneira comum e eficiente de lidar com eventos.

Se você quiser criar seus próprios objetos Event , use o método Add ou AddAdvise .

Para criar um objeto Event que execute um complemento, use o método Add, uma vez que ele aplica-se à coleção EventList.

Para criar um objeto Event que receba notificação, use o método AddAdvise.

Para localizar um código de evento que você deseja criar, consulte Códigos de eventos.

Você pode adicionar eventos DocumentCreated à coleção EventList de um objeto Application, coleção Documents ou objeto Document. As duas primeiras são diretas; se um documento é aberto ou criado no escopo do objeto Application ou sua coleção Documents, o evento DocumentCreated ocorre.

No entanto, adicionar um evento DocumentCreated à coleção EventList de um objeto Document só faz sentido se a ação do evento for visActCodeRunAddon. Nesse caso, o evento é persistência; ele pode ser armazenado com o documento. Se o documento que contém o evento persistente for aberto, sua ação será disparada. Se um novo documento for baseado ou copiado do documento que contém o evento persistente, o evento DocumentCreated será copiado para o novo documento e sua ação será disparada. No entanto, se a ação do evento for visActCodeAdvise, esse evento não será persistente e, portanto, não será armazenado com o documento; portanto, ele nunca é disparado.

Você pode impedir que códigos sejam executados em resposta ao evento DocumentCreated, DocumentOpened ou DocumentAdded e que todos os eventos sejam disparados, definindo o valor da propriedade EventsEnabled de um objeto Application para False.

Exemplo

Este exemplo VBA mostra como contar formas adicionadas a um desenho com base em um mestre chamado Square.

O manipulador de eventos DocumentCreated é executado quando um novo desenho com base no modelo que contém esse código é criado. O manipulador inicializa uma variável inteira, intNumberOfSquares, usada para armazenar a contagem.

O manipulador de eventos ShapeAdded é executado a cada vez que uma forma é adicionada à página de desenho, seja a forma arrastada de um estêncil, desenhada com uma ferramenta de desenho ou colada a partir da Área de transferência. O manipulador verifica a propriedade Mestre da nova forma e, se a forma for baseada no mestre square , incrementa intNumberOfSquares.

 
Dim intNumberOfSquares As Integer 
 
Private Sub Document_DocumentCreated(ByVal vsoDocument As Visio.IVDocument) 
 
'Initialize number of squares added. 
 intNumberOfSquares = 0 
 
End Sub 
 
 
Private Sub Document_ShapeAdded(ByVal vsoShape As Visio.IVShape) 
 
 Dim vsoMaster As Visio.Master 
 
 'Get the Master property of the shape. 
 'the shape was created locally. 
 Set vsoMaster = vsoShape.Master 
 
 'Check whether the shape has a master. If not, 
 If Not (vsoMaster Is Nothing) Then 
 
 'Check whether the master is "Square". 
 If vsoMaster.Name = "Square" Then 
 
 'Increment the count for the number of squares added. 
 intNumberOfSquares = intNumberOfSquares + 1 
 
 End If 
 
 End If 
 
 MsgBox "Number of squares: " & intNumberOfSquares, vbInformation, _ 
 "Document Created Example" 
 
End Sub

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.