Un menú personalizado en una instancia de la interfaz de usuario de una app de Google. Una secuencia de comandos solo puede interactuar con la IU de la instancia actual de un documento o formulario abierto, y solo si la secuencia de comandos está vinculada al contenedor del documento o formulario. Para obtener más información, consulta la guía de menús.
// Add a custom menu to the active spreadsheet, including a separator and a sub-menu.
function onOpen(e) {
SpreadsheetApp.getUi()
.createMenu('My Menu')
.addItem('My Menu Item', 'myFunction')
.addSeparator()
.addSubMenu(SpreadsheetApp.getUi().createMenu('My Submenu')
.addItem('One Submenu Item', 'mySecondFunction')
.addItem('Another Submenu Item', 'myThirdFunction'))
.addToUi();
}
Métodos
| Método | Tipo de datos que se muestra | Descripción breve |
|---|---|---|
addItem(caption, functionName) | Menu | Agrega un elemento al menú. |
addSeparator() | Menu | Agrega un separador visual al menú. |
addSubMenu(menu) | Menu | Agrega un submenú al menú. |
addToUi() | void | Inserta el menú en la instancia de la interfaz de usuario del editor. |
Documentación detallada
addItem(caption, functionName)
Agrega un elemento al menú. La etiqueta de un elemento de menú debe estar en mayúscula inicial (solo la primera palabra en mayúscula).
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
caption | String | La etiqueta del elemento de menú, con solo la primera palabra en mayúscula. |
functionName | String | Es el nombre de la función que se invocará cuando el usuario seleccione el elemento. Puedes usar funciones de las bibliotecas incluidas, como Library.libFunction1. |
Devolvedor
addSeparator()
addSubMenu(menu)
addToUi()
Inserta el menú en la instancia de la interfaz de usuario del editor.