Conteúdo

# Funções definidas pelo utilizador

É possível aplicar funções definidas pelo utilizador no LibreOffice Calc das seguintes formas:

- Pode definir as suas próprias funções utilizando o Basic IDE. Este método requer conhecimentos básicos de programação.

- Pode programar funções como extras. Este método requer conhecimentos avançados de programação.

## Definir uma função utilizando o LibreOffice Basic

1. Escolha Ferramentas – Macros – Editar macros.

2. Surgirá a interface do Basic IDE.

3. Na janela Catálogo do objeto, clique duas vezes no módulo em que deseja armazenar a sua macro.

4. Digite o código da função. Neste exemplo, definimos a função VOL(a;b;c) que calcula o volume de um sólido retangular com lados a, b e c:

        Function VOL(a, b, c)
            VOL = a*b*c
        End Function

- Feche a janela do Basic IDE.

  A sua função é guardada automaticamente no módulo selecionado e ficará imediatamente disposível. Se aplicar a função num documento do Calc que esteja a ser usado em outro computador, pode copiar a função para o documento do Calc conforme descrito na próxima seção.

## Copiar uma função para um documento

Na segunda fase de "Definir uma função utilizando o LibreOffice Basic", na caixa de diálogo Macro, você clicou em Editar. Por norma, no campo Macro de, o módulo As minhas macros - Standard - Module1 está selecionado. A biblioteca Standard está localizada no diretório do utilizador.

Se pretender copiar a função definida pelo utilizador para um documento do Calc:

1. Escolha Ferramentas – Macros – Organizar macros - Basic.

2. No campo Macro de, selecione As minhas macros - Standard - Module1, e clique em Editar.

3. No Basic IDE, selecione a origem da função definida pelo utilizador e copie-a para a área de transferência.

4. Feche o Basic IDE.

5. Escolha Ferramentas – Macros – Organizar macros - Basic.

6. No campo Macro de, selecione (Nome do documento do Calc) - Standard - Module1. Clique em Editar.

7. Cole o conteúdo da área de transferência no documento do Basic IDE.

## Aplicar uma função definida pelo utilizador no LibreOffice Calc

Definida a função VOL(a;b;c) na IDE do Basic, você pode utiliza-la da mesma maneira que as funções internas do LibreOffice Calc.

1. Abra um documento do Calc e introduza os números para os parâmetros a,b e c nas células A1, B1 e C1.

2. Coloque o cursor noutra célula e introduza o seguinte:

   =VOL(A1;B1;C1)

3. A função é avaliada e o resultado é mostrado na célula selecionada.

Tópicos relacionados

Calcular em folhas de cálculo

Introduzir fórmulas

Invocar scripts Python a partir do Basic