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 , , ou do ícone . |
OnCopyTo |
Foi criada uma cópia do documento |
...depois de um documento ser guardado através das opções , , ou do ícone . |
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
Escolha Ferramentas - Personalizar e clique no separador Eventos.
Selecione se pretende que a atribuição seja globalmente válida ou apenas válida no documento atual na caixa de lista Guardar em.
Selecione o evento na lista Evento.
Clique em Macro e selecione a macro que pretende atribuir ao evento selecionado.
Clique em Aceitar para atribuir a macro.
Clique em Aceitar para fechar a caixa de diálogo.
Remover a atribuição de uma macro a um evento
Escolha Ferramentas - Personalizar e clique no separador Eventos.
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.
Selecione o evento que possui a atribuição que pretende remover da lista Evento.
Clique em Remover.
Clique em Aceitar para fechar a caixa de diálogo.
