Class Menu

Menü

Ein benutzerdefiniertes Menü in einer Instanz der Benutzeroberfläche für eine Google-App. Ein Skript kann nur mit der Benutzeroberfläche für die aktuelle Instanz eines geöffneten Dokuments oder Formulars interagieren und nur, wenn das Skript containergebunden an das Dokument oder Formular ist. Weitere Informationen finden Sie im Leitfaden zu 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();
}

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
addItem(caption, functionName)	Menu	Fügt dem Menü ein Element hinzu.
addSeparator()	Menu	Fügt dem Menü ein visuelles Trennzeichen hinzu.
addSubMenu(menu)	Menu	Fügt dem Menü ein Untermenü hinzu.
addToUi()	void	Fügt das Menü in die Instanz der Benutzeroberfläche des Editors ein.

Detaillierte Dokumentation

addItem(caption, functionName)

Fügt dem Menü ein Element hinzu. Das Label für ein Menüelement sollte im Satzstil formatiert sein (nur das erste Wort wird großgeschrieben).

Parameter

Name	Typ	Beschreibung
caption	String	Das Label für den Menüpunkt, wobei nur das erste Wort großgeschrieben wird.
functionName	String	Der Name der Funktion, die aufgerufen werden soll, wenn der Nutzer das Element auswählt. Sie können Funktionen aus enthaltenen Bibliotheken wie Library.libFunction1 verwenden.

Rückflug

Menu – Diese Menu zur Verkettung.

---

addSeparator()

Fügt dem Menü ein visuelles Trennzeichen hinzu.

Rückflug

Menu – Diese Menu zur Verkettung.

---

addSubMenu(menu)

Fügt dem Menü ein Untermenü hinzu.

Parameter

Name	Typ	Beschreibung
menu	Menu	Das Untermenü ist wie ein Menü der obersten Ebene aufgebaut.

Rückflug

Menu – Diese Menu zur Verkettung.

---

addToUi()

Fügt das Menü in die Instanz der Benutzeroberfläche des Editors ein.