Método Application.MacroOptions (Excel)

  • Artículo

Corresponde a las opciones del cuadro de diálogo Opciones de macro. También puede usar este método para mostrar una función definida por el usuario (UDF) en una categoría integrada o nueva en el cuadro de diálogo Insertar función .

Sintaxis

expresión. MacroOptions (Macro, Description, HasMenu, MenuText, HasShortcutKey, ShortcutKey, Category, StatusBar, HelpContextID, HelpFile, ArgumentDescriptions)

expresión Variable que representa un objeto Application.

Parámetros

Nombre Obligatorio/opcional Tipo de datos Descripción
Macro Opcional Variant Nombre de macro o nombre de una función definida por el usuario (UDF).
Descripción Opcional Variant Descripción de la macro.
HasMenu Opcional Variant Este argumento se omite.
MenuText Opcional Variant Este argumento se omite.
HasShortcutKey Opcional Variant True para asignar a la macro una tecla de método abreviado (también debe especificarse el argumento ShortcutKey). Si el argumento es False, no se asignará ninguna tecla de método abreviado a la macro. Si la macro ya tiene tecla de método abreviado, esta se eliminará al establecer el valor del argumento en False. El valor predeterminado es False.
ShortcutKey Opcional Variant Obligatorio si HasShortcutKey es True; ignorado en caso contrario. La tecla de método abreviado
Category Opcional Variant Entero que especifica una categoría de función de macro existente (financiera, fecha y hora o definidas por el usuario, por ejemplo). Vea la sección de Observaciones para determinar los enteros asignados a las categorías integradas.

También puede especificar una cadena para una categoría personalizada. Si proporciona una cadena, se trata como el nombre de categoría que se muestra en el cuadro de diálogo Insertar función . Si el nombre de categoría nunca se ha usado, se define una nueva categoría con ese nombre. Si usa un nombre de categoría que es el mismo que un nombre integrado (vea la lista en la sección Comentarios), Excel asigna la función definida por el usuario a esa categoría integrada.
StatusBar Opcional Variant Texto de la barra de estado para la macro.
HelpContextID Opcional Variant Entero que especifica el número de Id. de contexto del tema de la Ayuda asignado a la macro.
HelpFile Opcional Variant Nombre del archivo de Ayuda que contiene el tema de Ayuda definido por HelpContextId.
ArgumentDescriptions Opcional Array Matriz unidimensional que contiene las descripciones de los argumentos de una función definida por el usuario que se muestran en el cuadro de diálogo Argumentos de función.

Observaciones

En la tabla siguiente se indican los enteros asignados a las categorías integradas que se pueden utilizar en el parámetro Category.

Entero Categoría
1 Financieras
2 Fecha y hora
3 Matemáticas y trigonométricas
4 Estadísticas
5 Búsqueda y referencia
6 Base de datos
7 Texto
8 Lógicas
9 Información
10 Comandos
11 Personalización
12 Control de macros
13 DDE/Externas
14 Definidas por el usuario
15 Primera categoría personalizada
16 Segunda categoría personalizada
17 Tercera categoría personalizada
18 Cuarta categoría personalizada
19 Quinta categoría personalizada
20 Sexta categoría personalizada
21 Séptima categoría personalizada
22 Octava categoría personalizada
23 Novena categoría personalizada
24 Décima categoría personalizada
25 Undécima categoría personalizada
26 Duodécima categoría personalizada
27 Decimotercera categoría personalizada
28 Decimocuarta categoría personalizada
29 Decimoquinta categoría personalizada
30 Decimosexta categoría personalizada
31 Decimoséptima categoría personalizada
32 Decimoctava categoría personalizada

Ejemplo

En este ejemplo se agrega una macro definida por el usuario denominada TestMacro a una categoría personalizada denominada Mi categoría personalizada. Después de ejecutar este ejemplo, debería ver Mi categoría personalizada, que contiene la función definida por el usuario TestMacro, en la lista desplegable O seleccione una categoría en el cuadro de diálogo Insertar función .

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

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.