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 ver más 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 escrita en mayúscula inicial (solo la primera (la palabra en mayúscula).
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
caption | String | Es la etiqueta del elemento de menú, que contiene solo la primera palabra en mayúsculas. |
functionName | String | Es el nombre de la función que se invocará cuando el usuario seleccione el elemento. Puedes
Usan funciones de las bibliotecas incluidas, como Library.libFunction1. |
Volver
addSubMenu(menu)
addToUi()
Inserta el menú en la instancia de la interfaz de usuario del editor.