Class Menu

Menü

Ein benutzerdefiniertes Menü in einer Instanz der Benutzeroberfläche einer Google-App. Ein Script kann nur mit der Benutzeroberfläche der aktuellen Instanz eines geöffneten Dokuments oder Formulars interagieren und nur, wenn das Script 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	Dem Menü wird ein visueller Trennstrich hinzugefügt.
addSubMenu(menu)	Menu	Fügt dem Menü ein Untermenü hinzu.
addToUi()	void	Das Menü wird in die Instanz der Benutzeroberfläche des Editors eingefügt.

Detaillierte Dokumentation

addItem(caption, functionName)

Fügt dem Menü ein Element hinzu. Das Label für einen Menüpunkt sollte in Großbuchstaben geschrieben werden, wobei nur das erste Wort großgeschrieben wird.

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 den enthaltenen Bibliotheken wie Library.libFunction1 verwenden.

Rückgabe

Menu – Dieses Menu für die Verkettung.

---

addSeparator()

Dem Menü wird ein visueller Trennstrich hinzugefügt.

Rückgabe

Menu – Dieses Menu für die Verkettung.

---

addSubMenu(menu)

Fügt dem Menü ein Untermenü hinzu.

Parameter

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

Rückgabe

Menu – Dieses Menu für die Verkettung.

---

addToUi()

Das Menü wird in die Instanz der Benutzeroberfläche des Editors eingefügt.