Ein benutzerdefiniertes Menü in einer Instanz der Benutzeroberfläche für eine Google-Anwendung. Ein Skript kann nur mit der Benutzeroberfläche für die aktuelle Instanz eines geöffneten Dokuments oder Formulars interagieren, und nur, wenn es 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. Beim Label für einen Menüpunkt sollte die Groß-/Kleinschreibung im Satzanfang verwendet werden (nur das erste Wort ist 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 wird, wenn der Nutzer das Element auswählt. Sie können Funktionen aus enthaltenen Bibliotheken wie Library.libFunction1 verwenden. |
Return
addSeparator()
addSubMenu(menu)
addToUi()
Fügt das Menü in die Instanz der Benutzeroberfläche des Editors ein.