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
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 einen Menüpunkt sollte im Satz immer großgeschrieben werden (nur das erste Wort in Großbuchstaben).
Parameter
Name | Typ | Beschreibung |
---|---|---|
caption | String | Label für den Menüpunkt, wobei nur das erste Wort großgeschrieben wird. |
functionName | String | Der 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
addSeparator()
addSubMenu(menu)
addToUi()
Fügt das Menü in die Instanz der Benutzeroberfläche des Editors ein.