Compartilhar via

Using Events with the Document Object

  • Artigo

O objeto Document dá suporte a vários eventos que permitem que você responda ao estado de um documento. Você grava procedimentos para responder a esses eventos no módulo de classe chamado "ThisDocument". Use as etapas a seguir para criar um procedimento de evento.

  1. Em seu projeto Normal ou no projeto de documento da janela do Explorador de projeto, clique duas vezes em ThisDocument. (Em modo de exibição de pasta, ThisDocument está localizado na pasta Objetos do Microsoft Word).

  2. Selecione Document na caixa de listagem drop-down Objeto.Uma sub-rotina vazia é adicionada ao módulo de classe para o evento New.

  3. Selecione um evento na caixa de listagem drop-down Procedimento. Uma sub-rotina vazia é adicionada ao módulo de classe para o evento selecionado.

  4. Adicione as instruções do Visual Basic que você deseja executar quando o evento ocorrer.

O exemplo a seguir mostra um novo procedimento de evento no projeto Normal que será executado quando um novo documento baseado no modelo Normal for criado.

Private Sub Document_New() 
 MsgBox "New document was created" 
End Sub

O exemplo a seguir mostra um procedimento de evento Fechar em um projeto de documento que é executado somente quando esse documento é fechado.

Private Sub Document_Close() 
 MsgBox "Closing the document" 
End Sub

Ao contrário das macros automáticas, os procedimentos de evento no modelo Normal não têm um escopo global. Por exemplo, os procedimentos de evento no modelo normal ocorrem somente se o modelo anexado for o modelo Normal. Caso exista uma macro automática em um documento e no modelo anexado, somente a macro automática armazenada no documento será executada. Se um procedimento de evento para um evento Document existir em um documento e em seu modelo anexado, ambos os procedimentos de evento serão executados.

Comentários

Para obter informações sobre como criar procedimentos de evento para o objeto Application , consulte Usando Eventos com o Objeto de Aplicativo.

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.