Class Menu

Menü

Ein benutzerdefiniertes Menü in einer Instanz der Benutzeroberfläche für eine Google-App. Ein Script kann nur mit mit der UI für die aktuelle Instanz eines offenen Dokuments oder Formulars und nur dann, wenn das Skript an das Dokument oder Formular containergebunden ist. Weitere Informationen Weitere Informationen finden Sie im Leitfaden zu Speisekarten.

// 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. Bei der Beschriftung eines Menüpunkts sollte die erste Groß- und Kleinschreibung beachtet werden (nur die erste Großschreibung des Wortes).

Parameter

NameTypBeschreibung
captionStringDas Label für den Menüpunkt (nur das erste Wort großgeschrieben)
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.

Rückflug

Menu: Diese Menu zum Verketten.


addSeparator()

Fügt dem Menü ein visuelles Trennzeichen hinzu.

Rückflug

Menu: Diese Menu zum Verketten.


addSubMenu(menu)

Fügt dem Menü ein Untermenü hinzu.

Parameter

NameTypBeschreibung
menuMenuDas Untermenü ist wie ein Menü der obersten Ebene aufgebaut.

Rückflug

Menu: Diese Menu zum Verketten.


addToUi()

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