Class Menu

Menü

Ein benutzerdefiniertes Menü in einer Instanz der Benutzeroberfläche für eine Google-App. Ein Skript kann nur mit der UI der aktuellen Instanz eines offenen Dokuments oder Formulars interagieren, wenn das Skript containergebunden ist. Weitere Informationen finden Sie in der Übersicht 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

MethodeRückgabetypKurzbeschreibung
addItem(caption, functionName)MenuFügt dem Menü ein Element hinzu.
addSeparator()MenuFügt dem Menü ein visuelles Trennzeichen hinzu.
addSubMenu(menu)MenuFügt dem Menü ein Untermenü hinzu.
addToUi()voidFü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 einen Menüpunkt sollte im Satz immer großgeschrieben werden (nur das erste Wort in Großbuchstaben).

Parameter

NameTypBeschreibung
captionStringLabel für den Menüpunkt, wobei nur das erste Wort großgeschrieben wird.
functionNameStringDer Name der Funktion, die aufgerufen wird, wenn der Nutzer das Element auswählt. Sie können Funktionen aus enthaltenen Bibliotheken wie Library.libFunction1 verwenden.

Zurücksenden

Menu: Menu zum Verketten.


addSeparator()

Fügt dem Menü ein visuelles Trennzeichen hinzu.

Zurücksenden

Menu: Menu zum Verketten.


addSubMenu(menu)

Fügt dem Menü ein Untermenü hinzu.

Parameter

NameTypBeschreibung
menuMenuDas Untermenü, das wie ein Menü auf oberster Ebene aufgebaut ist.

Zurücksenden

Menu: Menu zum Verketten.


addToUi()

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