Método Application.MacroOptions (Excel)

Corresponde às opções da caixa de diálogo Opções de Macro. Você também pode usar esse método para exibir uma UDF (função definida pelo usuário) em uma categoria interna ou nova na caixa de diálogo Inserir Função .

Sintaxe

expressão. MacroOptions (Macro, Description, HasMenu, MenuText, HasShortcutKey, ShortcutKey, Category, StatusBar, HelpContextID, HelpFile, ArgumentDescriptions)

expressão Uma variável que representa um Aplicativo objeto.

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Macro	Opcional	Variant	O nome da macro ou o nome de uma UDF (função definida pelo usuário).
Descrição	Opcional	Variant	A descrição da macro.
HasMenu	Opcional	Variant	Este argumento é ignorado.
Menutext	Opcional	Variant	Este argumento é ignorado.
HasShortcutKey	Opcional	Variant	True para atribuir uma tecla de atalho à macro (ShortcutKey também deve ser especificado). Se esse argumento for False, nenhuma tecla de atalho será atribuída à macro. Se a macro já possuir uma tecla de atalho, a configuração desse argumento como False removerá a tecla de atalho. O valor padrão é False.
ShortcutKey	Opcional	Variant	Necessário se HasShortcutKey for True e ignorado caso contrário. A tecla de atalho.
Categoria	Opcional	Variant	Um inteiro que especifica a categoria da função de uma macro existente (Financeira, Data & Hora ou Definida pelo Usuário, por exemplo). Consulte a seção Comentários para determinar quais inteiros são mapeados para as categorias internas. Você também pode especificar uma cadeia de caracteres para uma categoria personalizada. Se você fornecer uma cadeia de caracteres, ela será tratada como o nome da categoria exibido na caixa de diálogo Inserir Função . Se o nome da categoria nunca foi usado, será definida uma nova categoria com esse nome. Se você usar um nome de categoria igual a um nome interno (consulte lista na seção Comentários), o Excel mapeia a função definida pelo usuário para essa categoria interna.
StatusBar	Opcional	Variant	O texto de barra de status para a macro.
HelpContextID	Opcional	Variant	Um número inteiro especificando a identificação de contexto do tópico da Ajuda atribuído à macro.
HelpFile	Opcional	Variant	O nome do arquivo de ajuda que contém o tópico da Ajuda definido por HelpContextId.
ArgumentDescriptions	Opcional	Array	Uma matriz unidimensional que contém as descrições dos argumentos para uma UDF exibida na caixa de diálogo Argumentos de Função .

Comentários

A tabela a seguir lista os inteiros mapeados para as categorias internas que podem ser usados no parâmetro Category.

Número inteiro	Categoria
1	Financeiro
2	Data & Hora
3	Matemática e Trigonométrica
4	Estatística
5	Procura e Referência
6	Banco de dados
7	Text
8	Lógica
9	Information
10	Comandos
11	Personalização
12	Controle de Macro
13	DDE/Externo
14	Definida pelo Usuário
15	Primeira categoria personalizada
16	Segunda categoria personalizada
17	Terceira categoria personalizada
18	Quarta categoria personalizada
19	Quinta categoria personalizada
20	Sexta categoria personalizada
21	Sétima categoria personalizada
22	Oitava categoria personalizada
23	Nona categoria personalizada
24	Décima categoria personalizada
25	Décima primeira categoria personalizada
26	Décima segunda categoria personalizada
27	Décima terceira categoria personalizada
28	Décima quarta categoria personalizada
29	Décima quinta categoria personalizada
30	Décima sexta categoria personalizada
31	Décima sétima categoria personalizada
32	Décima oitava categoria personalizada

Exemplo

Este exemplo adiciona uma macro definida pelo usuário chamada TestMacro a uma categoria personalizada chamada Minha Categoria Personalizada. Depois de executar este exemplo, você deverá ver Minha Categoria Personalizada, que contém a função definida pelo usuário TestMacro, na lista suspensa Ou selecione uma categoria suspensa na caixa de diálogo Inserir Função .

Function TestMacro() 
    MsgBox ActiveWorkbook.Name 
End Function 
 
Sub AddUDFToCustomCategory() 
    Application.MacroOptions Macro:="TestMacro", Category:="My Custom Category" 
End Sub

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.