Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Corresponde às opções da caixa de diálogo Opções de Macro. Também pode utilizar este método para apresentar uma função definida pelo utilizador (UDF) numa categoria incorporada ou nova na caixa de diálogo Inserir Função .
Sintaxe
expressão. MacroOptions (Macro, Descrição, 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 função definida pelo utilizador (UDF). |
| 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 fornecer uma cadeia, esta é tratada como o nome da categoria que é apresentado 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 utilizar um nome de categoria que seja o mesmo que um nome incorporado (ver lista na secção Observações), o Excel mapeia a função definida pelo utilizador para essa categoria incorporada. |
| 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 um UDF que são apresentados 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 utilizador denominada TestMacro a uma categoria personalizada denominada A Minha Categoria Personalizada. Depois de executar este exemplo, deverá ver A Minha Categoria Personalizada, que contém a função definida pelo utilizador TestMacro, na lista pendente Ou selecione uma categoria 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.