Como usar a caixa de diálogo inserir função no excel 2016 vba

A caixa de diálogo Inserir função é uma ferramenta Excel útil que permite que você escolha uma função de planilha VBA a partir de uma lista e pede-lhe argumentos da função. Suas funções de planilha personalizadas também aparecem na caixa de diálogo Inserir função. As funções personalizadas aparecerão na categoria definida pelo usuário.

procedimentos função definida com a palavra-chave Private não aparecem na caixa de diálogo Inserir função. Portanto, se você escrever um procedimento Function que é projetado para ser usado apenas por outros procedimentos VBA (mas não em fórmulas), você deve declarar a função como particular.

Exibindo a descrição da função

A caixa de diálogo Inserir função exibe uma descrição de cada função built-in. Mas como você pode ver, uma função personalizada exibe o seguinte texto como sua descrição: Não há ajuda disponível.

Para exibir uma descrição significativa da sua função personalizada na caixa de diálogo Inserir função, executar alguns passos adicionais (nonintuitive):

1. Ative uma planilha na pasta de trabalho que contém a função personalizada.

2. Escolha desenvolvedor → Código → Macros (ou pressione Alt + F8).

   A caixa de diálogo Macro aparece.

3. No campo Nome da macro, digite o nome da função.

   Note que a função não aparecer na lista de Macros- você deve digitar o nome.

4. Clique no botão Opções.

   A caixa de diálogo Opções de macro aparece.

5. No campo Descrição, digite uma descrição da função.

6. 
   
   
   

   Clique em OK.

7. Clique em Cancelar.

   Agora, a caixa de diálogo Inserir função exibe a descrição de sua função.

   
   A função personalizada agora exibe uma descrição.

As funções personalizadas, por padrão, são listados na categoria definida pelo usuário. Para adicionar uma função para uma categoria diferente, você precisa usar VBA. Esta declaração, quando executado, adiciona a função TopAvg ao Math & Trig categoria (que é a categoria 3):

Application.MacroOptions Macro: = “TopAvg” Categoria: = 3

Verifique o sistema de Ajuda para outros números de categoria.

Você precisa executar esta declaração apenas uma vez. Depois de executá-lo (e guardar o livro), o número da categoria é atribuído de forma permanente para a função.

Adicionando descrições de argumento

Quando você acessa uma função built-in a partir da caixa de diálogo Inserir Função, a caixa de diálogo Argumentos da função exibe descrições dos argumentos.

Video: #08 - Macros e Excel VBA - Caixa de Combinação

No passado, não era possível adicionar descrições de argumentos. Mas começando com o Excel 2010, Microsoft finalmente implementado esse recurso. Você fornecer descrições de argumento usando o método MacroOptions. Aqui está um exemplo que adiciona descrições para os argumentos usados ​​pela função TopAvg:

AddArgumentDescriptions Sub () Application.MacroOptions Macro: = “TopAvg”, _ArgumentDescriptions: = _array ( “intervalo que contém os valores”, _ “Número de valores para calcular a média”) End Sub

Você precisa executar este procedimento apenas uma vez. Depois de executá-lo, as descrições de argumentos são armazenados na pasta de trabalho e estão associados com a função.

Video: Curso Básico de VBA - Aula 6 - Interação com o Usuário (MsgBox e InputBox)

Observe que as descrições de argumentos aparecem como argumentos para a função matriz. Você deve usar a função de matriz, mesmo que você está atribuindo uma descrição para uma função que tem apenas um argumento.