Class Menu

Menu

Menu personnalisé dans une instance de l'interface utilisateur d'une application Google. Un script ne peut interagir avec l'interface utilisateur d'un document ou d'un formulaire ouvert que s'il est lié à un conteneur par rapport au document ou au 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éthodeType renvoyéBrève description
addItem(caption, functionName)MenuAjoute un élément au menu.
addSeparator()MenuAjoute un séparateur visuel au menu.
addSubMenu(menu)MenuAjoute un sous-menu au menu.
addToUi()voidInsè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. L'étiquette d'un élément de menu doit être en début de phrase (uniquement le premier mot en majuscule).

Paramètres

NomTypeDescription
captionStringLibellé de l'élément de menu, avec uniquement le premier mot en majuscule.
functionNameStringNom de la fonction à appeler lorsque l'utilisateur sélectionne l'élément. Vous pouvez utiliser les fonctions des bibliothèques incluses, telles que Library.libFunction1.

Aller-retour

Menu : cet élément (Menu) pour le chaînage.


addSeparator()

Ajoute un séparateur visuel au menu.

Aller-retour

Menu : cet élément (Menu) pour le chaînage.


addSubMenu(menu)

Ajoute un sous-menu au menu.

Paramètres

NomTypeDescription
menuMenuSous-menu, construit comme un menu principal.

Aller-retour

Menu : cet élément (Menu) pour le chaînage.


addToUi()

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