Compartilhar via


Using Events with the Document Object

O objeto Documento suporta vários eventos que lhe permitem responder ao estado de um documento. Escreve procedimentos para responder a estes eventos no módulo de classe denominado "ThisDocument". Utilize os seguintes passos 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 seguinte mostra um novo procedimento de evento no projeto Normal que será executado quando é criado um novo documento baseado no modelo Normal.

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

O exemplo seguinte mostra um procedimento Fechar evento num projeto de documento que é executado apenas quando esse documento é fechado.

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

Ao contrário das macros automáticas, os procedimentos de eventos no modelo Normal não têm um âmbito global. Por exemplo, os procedimentos de eventos no modelo Normal só ocorrem 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 a criação de procedimentos de eventos para o objeto Aplicação , veja Using Events with the Application Object (Utilizar Eventos com o Objeto da Aplicação).

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.