Conteúdo

# Documentação sobre macros orientadas por eventos

Esta secção descreve como atribuir scripts a eventos de aplicações, documentos ou formulários.

É possível executar automaticamente uma macro quando ocorre um evento de software específico, atribuindo a macro pretendida a esse evento. A tabela seguinte apresenta uma visão geral dos eventos do documento e indica em que momento uma macro atribuída é executada.

Evento | Uma macro atribuída é executada... | rotina
--- | --- | ---
Iniciar candidatura | ...após o início de uma aplicação LibreOfficeDev. | OnStartApp
Fechar aplicação | ...antes de uma aplicação do LibreOfficeDev ser encerrada. | OnCloseApp
Documento criado | ...Documento novo criado através de Ficheiro - Novo ou do ícone Novo. Note-se que este evento também é acionado quando o Basic IDE é aberto. | OnCreate
Novo documento | ...depois de ser criado um novo documento com Ficheiro - Novo ou através do ícone Novo. | OnNew
O carregamento do documento foi concluído | ...antes de um documento ser aberto através de Ficheiro - Abrir ou do ícone Abrir. | OnLoadFinished
Abrir documento | ...depois de um documento ser aberto com Ficheiro - Abrir ou através do ícone Abrir. | OnLoad
O documento vai ser fechado | ...antes de um documento ser fechado. | OnPrepareUnload
Documento fechado | ...depois de um documento ter sido fechado. Note que o evento "Guardar documento" pode também ocorrer quando o documento é guardado antes de ser fechado. | OnUnload
-no UI- |  | OnLayoutFinished
Vista criada | O documento é apresentado. Note-se que este evento também ocorre quando um documento é duplicado. | OnViewCreated
A vista vai ser encerrada | O layout do documento está a ser removido. | OnPrepareViewClosing
View closed | A disposição do documento é reiniciada antes do seu encerramento. | OnViewClosed
Ativar documento | ...depois de um documento ser trazido para primeiro plano. | OnFocus
Desativar documento | ...depois de outro documento ser trazido para primeiro plano. | OnUnfocus
Guardar documento | ...antes de um documento ser guardado com Ficheiro - Guardar ou o ícone Guardar, desde que o nome do documento já tenha sido especificado. | OnSaveAs
O documento foi guardado | ...depois de um documento ter sido guardado com Ficheiro - Guardar ou através do ícone Guardar, desde que o nome do documento já tenha sido especificado. | OnSaveDone
Não foi possível guardar o documento | Não foi possível guardar o documento. | OnSaveFailed
Guardar documento como | ...antes de um documento ser guardado com um nome específico (com Ficheiro - Guardar como, com Ficheiro - Guardar ou através do ícone Guardar, se o nome do documento não foi ainda especificado). | OnSaveAs
O documento foi guardado como | ... depois de um documento ter sido guardado com um nome específico (com Ficheiro - Guardar como, com Ficheiro - Guardar ou através do ícone Guardar, se o nome do documento ainda não tiver sido especificado). | OnSaveAsDone
A função «Guardar como» falhou | Não foi possível guardar o documento. | OnSaveAsFailed
-sem interface de utilizador- | Quando a localização do documento no disco foi alterada, por exemplo, após uma ação Ficheiro - Guardar como. | OnStorageChanged
Guardar ou exportar uma cópia do documento | ...antes de um documento ser guardado através das opções Ficheiro - Guardar uma cópia, Ficheiro - Exportar, Ficheiro - Exportar como PDF ou do ícone Guardar. | OnCopyTo
Foi criada uma cópia do documento | ...depois de um documento ser guardado através das opções Ficheiro - Guardar uma cópia, Ficheiro - Exportar, Ficheiro - Exportar como PDF ou do ícone Guardar. | OnCopyToDone
Falha na criação da cópia do documento | Não foi possível copiar ou exportar o documento. | OnCopyToFailed
Imprimir documento | ...depois de a caixa de diálogo de impressão ser fechada, mas antes de o processo de impressão propriamente dito começar. Este evento ocorre para cada cópia impressa. | OnPrint
-sem interface- | ...após a alteração das definições de segurança do documento. | OnModeChanged
O estado «Modificado» foi alterado | O estado de modificação de um documento foi alterado. | OnModifyChanged
O título do documento foi alterado | Quando o título do documento for atualizado. | OnTitleChanged
Carregou um subcomponente | ...depois de um formulário da base de dados ter sido aberto. | OnSubComponentOpened
Fechou um subcomponente | ...after a database form has been closed. | OnSubComponentClosed
Iniciou-se a impressão das cartas-modelo | ...antes de imprimir cartas-modelo através dos menus Ficheiro - Imprimir ou Ferramentas - Assistente de mala direta. | OnMailMerge
A impressão das cartas-modelo está concluída | ...após a impressão de cartas-modelo através dos menus Ficheiro - Imprimir ou Ferramentas - Assistente de mala direta. | OnMailMergeFinished
Início da impressão dos campos do formulário | ...antes de imprimir os campos do formulário. | OnFieldMerge
A impressão dos campos do formulário foi concluída | ...após imprimir os campos do formulário. | OnFieldMergeFinished
Alterar total de páginas | Quando o número de páginas muda. | OnPageCountChanged

A maioria dos eventos está relacionada com documentos, exceto OnStartApp, OnCloseApp, OnCreate e OnLoadFinished, que ocorrem ao nível da aplicação. Os eventos OnSubComponentOpened e OnSubComponentClosed são acionados pelos formulários da base de dados.

Os documentos do Writer acionam estes eventos específicos: OnLayoutFinished, OnMailMerge, OnMailMergeFinished, OnFieldMerge, OnFieldMergeFinished e OnPageCountChanged.

## Atribuir uma macro a um evento

1. Escolha Ferramentas - Personalizar e clique no separador Eventos.

2. Selecione se pretende que a atribuição seja globalmente válida ou apenas válida no documento atual na caixa de lista Guardar em.

3. Selecione o evento na lista Evento.

4. Clique em Macro e selecione a macro que pretende atribuir ao evento selecionado.

5. Clique em Aceitar para atribuir a macro.

6. Clique em Aceitar para fechar a caixa de diálogo.

## Remover a atribuição de uma macro a um evento

1. Escolha Ferramentas - Personalizar e clique no separador Eventos.

2. Selecione se pretende remover uma atribuição globalmente ou apenas válida no documento atual, selecionando a opção na caixa de lista Guardar em.

3. Selecione o evento que possui a atribuição que pretende remover da lista Evento.

4. Clique em Remover.

5. Clique em Aceitar para fechar a caixa de diálogo.

Tópicos relacionados

Para além de atribuir macros a eventos, é possível monitorizar eventos desencadeados em documentos LibreOfficeDev.

Necessitamos da sua ajuda!