Conteúdo
Índice 🔎︎

# Atribuir scripts no LibreOffice

Pode atribuir scripts (macros) personalizados a itens de menu, ícones, controlos de caixas de diálogo e eventos no LibreOffice.

O LibreOffice tem suporte às seguintes linguagens de script:

1. LibreOffice Basic

2. JavaScript

3. BeanShell

4. Python

Adicionalmente, os programadores podem utilizar linguagens de programação avançadas, por exemplo a linguagem Java, para controlar externamente o LibreOffice. A nossa API está disponível em api.libreoffice.org.

## Para atribuir um script a uma nova entrada de menu

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

2. Clique em Adicionar.

3. Na caixa da lista Categoria, mova para baixo e abra a entrada "Macros do LibreOffice".

4. São apresentadas entradas para "Macros do LibreOffice" (scripts no diretório partilhado da instalação do LibreOffice), "As minhas macros" (scripts no diretório do utilizador) e o documento atual. Abra qualquer uma destas entradas para visualizar as linguagens de script suportadas.

5. Abra qualquer entrada de linguagem de script para visualizar os scripts disponíveis. Selecione um.

6. É apresentada uma lista de funções de script na caixa de lista Comandos. Selecione uma.

7. Clique em Adicionar para criar uma nova atribuição de menu. A nova entrada de menu é apresentada na caixa de lista Entradas.

## Para atribuir um script a uma combinação de teclas

1. Escolha Ferramentas - Personalizar - Teclado.

2. Na caixa da lista Categoria, mova para baixo e abra a entrada "Macros do LibreOffice".

3. São apresentadas entradas para "Macros do LibreOffice" (scripts no diretório partilhado da instalação do LibreOffice), "As minhas macros" (scripts no diretório do utilizador) e o documento atual. Abra qualquer uma destas entradas para visualizar as linguagens de script suportadas.

4. Abra qualquer entrada de linguagem de script para visualizar os scripts disponíveis. Selecione um.

5. Será apresentada uma lista de funções de scripts na caixa de lista Comandos. Selecione uma.

6. Clique no botão de opção para LibreOffice ou para Writer (ou para qualquer aplicação que esteja aberta).

   A seleção do botão de opção define o âmbito da nova combinação de teclas a ser aplicada no LibreOffice ou apenas nos documentos do módulo atual.

7. Selecione uma combinação de teclas na caixa de lista Teclas de atalho e clique em Modificar.

## Para atribuir um script a um evento

1. Escolha Ferramentas - Personalizar - Eventos.

2. Clique no botão Macro.

3. Na caixa de lista Biblioteca, desloque para baixo e abra a entrada "Macros do LibreOffice".

4. São apresentadas entradas para "Macros do LibreOffice" (scripts no diretório partilhado da instalação do LibreOffice), "As minhas macros" (scripts no diretório do utilizador) e o documento atual. Abra qualquer uma destas entradas para visualizar as linguagens de script suportadas.

5. Abra qualquer entrada de linguagem de script para visualizar os scripts disponíveis. Selecione um.

6. Será apresentada uma lista de funções de script na caixa de lista Ação atribuída. Selecione uma.

7. Selecione a opção de guardar no LibreOffice ou no documento atual.

   Esta ação define o âmbito da nova atribuição de eventos a ser aplicada no LibreOffice, ou apenas nos documentos do módulo atual.

8. Selecione um evento da lista e clique em Aceitar.

## Para atribuir um script a um evento de um objeto incorporado

1. Selecione o objeto incorporado no documento, como por exemplo um gráfico.

2. Escolha Formatar - Moldura e objeto - Propriedades - Macro.

3. Na caixa de lista Macros, abra a entrada Scripts do LibreOffice.

4. Pode visualizar entradas para partilhar (scripts no mesmo diretório da instalação do LibreOffice), o utilizador (scripts no diretório do utilizador) e o documento atual. Abra qualquer uma destas entradas para visualizar as linguagens de script suportadas.

5. Abra qualquer entrada de linguagem de script para visualizar os scripts disponíveis. Selecione um.

6. É apresentada uma lista de funções de script na caixa de lista Macros existentes em. Selecione uma.

7. Selecione um evento da lista e clique em Aceitar.

## Para atribuir um script a uma hiperligação

1. Posicione o cursor dentro da hiperligação.

2. Escolha Inserir - Hiperligação.

3. Clique no botão Eventos.

4. Selecione e atribua conforme acima indicado.

## Para atribuir um script a uma imagem

1. Selecione a imagem no documento.

2. Escolha Formatar - Imagem - Propriedades - Macro.

3. Selecione e atribua conforme acima indicado.

## Para atribuir um script a um controlo de formulário

1. Insira um controlo de formulário, como por exemplo: a barra de ferramentas Abrir o Controlo de Formulário, clique no ícone Botão de Ação e arraste e abra um botão no documento.

2. Após ter selecionado o controlo de formulário, clique em Controlo na barra de ferramentas Controlos de formulário.

3. Clique no separador Eventos na caixa de diálogo Propriedades.

4. Clique num dos botões ... para abrir uma caixa de diálogo na qual é possível atribuir um script ao evento selecionado.

## Para atribuir um script a um controlo na caixa de diálogo do LibreOffice Basic

1. Abra o editor da caixa de diálogo do LibreOffice Basic e crie uma caixa de diálogo com um controlo.

2. Clique com o botão direito do rato no controlo, e escolha Propriedades.

3. Clique no separador Eventos na caixa de diálogo Propriedades.

4. Clique num dos botões ... para abrir uma caixa de diálogo na qual é possível atribuir um script ao evento selecionado.