Class Menu

Menu

Menu personnalisé dans une instance de l'interface utilisateur d'une application Google. Un script ne peut interagir avec l'UI que pour l'instance actuelle d'un document ou d'un formulaire ouverts, et uniquement si le script est lié au conteneur du document ou du formulaire. Pour en savoir plus, consultez le guide des 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éthodes

Méthode	Type renvoyé	Brève description
addItem(caption, functionName)	Menu	Ajoute un élément au menu.
addSeparator()	Menu	Ajoute un séparateur visuel au menu.
addSubMenu(menu)	Menu	Ajoute un sous-menu au menu.
addToUi()	void	Insère le menu dans l'instance de l'interface utilisateur de l'éditeur.

Documentation détaillée

addItem(caption, functionName)

Ajoute un élément au menu. Le libellé d'un élément de menu doit être en casse de phrase (seul le premier mot est en majuscule).

Paramètres

Nom	Type	Description
caption	String	Libellé de l'élément de menu, avec uniquement la première lettre du premier mot en majuscule.
functionName	String	Nom de la fonction à appeler lorsque l'utilisateur sélectionne l'élément. Vous pouvez utiliser des fonctions des bibliothèques incluses, telles que Library.libFunction1.

Renvois

Menu : ce Menu, pour le chaînage.

---

addSeparator()

Ajoute un séparateur visuel au menu.

Renvois

Menu : ce Menu, pour le chaînage.

---

addSubMenu(menu)

Ajoute un sous-menu au menu.

Paramètres

Nom	Type	Description
menu	Menu	Sous-menu, construit comme un menu de premier niveau.

Renvois

Menu : ce Menu, pour le chaînage.

---

addToUi()

Insère le menu dans l'instance de l'interface utilisateur de l'éditeur.