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.