Método Application.MacroOptions (Excel)
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.