Class Menu

Menu

Um menu personalizado em uma instância da interface do usuário de um Google app. Um script só pode interagir com a IU da instância atual de um documento ou formulário aberto e somente se o script estiver vinculado a um contêiner do documento ou formulário. Para mais 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 de usuário do editor.

Documentação detalhada

addItem(caption, functionName)

Adiciona um item ao menu. O rótulo de um item de menu deve ter a primeira letra maiúscula (somente o primeiro palavra em maiúscula).

Parâmetros

Nome	Tipo	Descrição
caption	String	Rótulo do item de menu, com apenas a primeira palavra em maiúscula.
functionName	String	O nome da função a ser invocada quando o usuário selecionar o item. Você pode use funções de bibliotecas incluídas, como Library.libFunction1.

Retornar

Menu: este Menu, para encadeamento.

---

addSeparator()

Adiciona um separador visual ao menu.

Retornar

Menu: este Menu, para encadeamento.

---

addSubMenu(menu)

Adiciona um submenu ao menu.

Parâmetros

Nome	Tipo	Descrição
menu	Menu	O submenu, criado como um menu de nível superior.

Retornar

Menu: este Menu, para encadeamento.

---

addToUi()

Insere o menu na instância da interface de usuário do editor.