Conteúdo
Índice 🔎︎

# Funções definidas pelo usuário

Você pode aplicar funções definidas pelo usuário no LibreOffice Calc das maneiras que se seguem:

- Você pode definir suas próprias funções usando o IDE do Basic. Esse método exige um conhecimento básico de programação.

- Você pode programar funções como suplementos (add-ins). Esse método exige um conhecimento avançado de programação.

## Definir uma função usando LibreOffice Basic

1. Escolha Ferramentas – Macros – Editar macros.

2. A IDE do Basic aparece.

3. Na janela do catálogo de objetos, faça um clique duplo no módulo onde deseja guardar 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 IDE do Basic.

  A sua função é automaticamente salva no módulo selecionado e está disponível. Se aplicar a função num documento do Calc que 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

No estágio 2 de "Definir uma função usando o LibreOffice Basic", na caixa de diálogo Macro, clique em Editar. No campo Macro de, o módulo Minhas macros - Standard - Module1 está selecionado como padrão. A biblioteca Standard reside no seu diretório local de usuário.

Para copiar a função definida pelo usuário para um documento Calc:

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

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

3. No IDE do Basic, selecione o código fonte da sua função e copie-a para a área de transferência.

4. Feche o IDE do Basic.

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 IDE do Basic do documento.

## Aplicar uma função definida pelo usuário no LibreOffice Calc

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

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

2. Coloque o cursor em outra célula e insira o seguinte:

   =VOL(A1;B1;C1)

3. A função é avaliada e você verá o resultado na célula selecionada.

Tópicos relacionados

Calcular em planilhas

Inserir fórmulas

Chamar scripts Python desde o Basic