Um menu personalizado em uma instância da interface do usuário de um Google app. Um script só pode interagir com a IU para a instância atual de um documento ou formulário aberto e somente se o script for vinculado ao contêiner no documento ou formulário. Para mais informações, consulte o guia de menus.
// 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 retorno | Breve descrição |
---|---|---|
addItem(caption, functionName) | Menu | Adiciona um item ao menu. |
addSeparator() | Menu | Adiciona um separador visual ao menu. |
addSubMenu(menu) | Menu | Adiciona um submenu ao menu. |
addToUi() | void | insere o menu na instância da interface do usuário do editor. |
Documentação detalhada
addItem(caption, functionName)
Adiciona um item ao menu. O rótulo de um item de menu precisa estar em letra maiúscula (somente a primeira palavra em letras maiúsculas).
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
caption | String | A etiqueta do item de menu, com apenas a primeira palavra em maiúsculo. |
functionName | String | Nome da função a ser invocada quando o usuário selecionar o item. É possível
usar funções de bibliotecas incluídas, como Library.libFunction1 . |
Retornar
addSubMenu(menu)
addToUi()
insere o menu na instância da interface do usuário do editor.