Benutzerdefinierte Menüs in Google Workspace

Scripts können bestimmte Google-Produkte durch Hinzufügen von Benutzeroberflächenelementen erweitern die beim Anklicken eine Apps Script-Funktion ausführen. Das häufigste Beispiel ist das Ausführen eines Scripts über einen benutzerdefinierten Menüpunkt in Google Docs, Google Tabellen, Google Präsentationen oder Google Formulare. Scriptfunktionen können aber auch durch Klicken auf Bilder und Zeichnungen in Google Tabellen ausgelöst werden.

Benutzerdefinierte Menüs in Google Docs, Google Tabellen, Google Präsentationen oder Google Formulare

Mit Apps Script lassen sich in Google Docs, Google Tabellen, oder Google Formulare mit jeden Menüpunkt, der mit einer Funktion in einem Skript verbunden ist. (In Google Formulare können mit benutzerdefinierten Menüs sind nur für den Bearbeiter sichtbar, der das Formular zum Bearbeiten öffnet, nicht für Nutzer, die das Formular bearbeiten. öffnet das Formular, um zu antworten.)

Ein Script kann nur ein Menü erstellen, wenn es an das Dokument, die Tabelle oder das Formular gebunden ist. Um das Menü anzuzeigen, wenn der Nutzer eine Datei öffnet, schreiben Sie den Menücode in eine onOpen()-Funktion.

Im folgenden Beispiel sehen Sie, wie Sie eine Speisekarte hinzufügen. mit einem Element, gefolgt von visuelles Trennzeichen, gefolgt von einem Untermenü mit den ein anderes Element. (Beachten Sie, dass in Google Tabellen, es sei denn, Sie verwenden das neue Version verfügbar ist, müssen Sie das addMenu() Syntax und Untermenüs sind nicht möglich.) Wenn der Nutzer entweder zeigt eine entsprechende Funktion alert. Weitere Informationen Informationen zu den Dialogtypen, die Sie öffnen können, finden Sie in der Leitfaden zu Dialogfeldern und Seitenleisten.

function onOpen() {
  var ui = SpreadsheetApp.getUi();
  // Or DocumentApp, SlidesApp or FormApp.
  ui.createMenu('Custom Menu')
      .addItem('First item', 'menuItem1')
      .addSeparator()
      .addSubMenu(ui.createMenu('Sub-menu')
          .addItem('Second item', 'menuItem2'))
      .addToUi();
}

function menuItem1() {
  SpreadsheetApp.getUi() // Or DocumentApp, SlidesApp or FormApp.
     .alert('You clicked the first menu item!');
}

function menuItem2() {
  SpreadsheetApp.getUi() // Or DocumentApp, SlidesApp or FormApp.
     .alert('You clicked the second menu item!');
}

Ein Dokument, eine Tabelle, eine Präsentation oder ein Formular darf nur ein Menü mit einen Vornamen. Wenn durch dasselbe Skript oder ein anderes Skript ein Menü ersetzt das neue Menü das alte. Menüs können nicht entfernt werden, solange die Datei ist geöffnet. Sie können aber die Funktion onOpen() schreiben, um das Menü in in der Zukunft liegen, wenn eine bestimmte Property festgelegt ist.

Anklickbare Bilder und Zeichnungen in Google Tabellen

Sie können einem Bild oder einer Zeichnung in Google Tabellen auch eine Apps Script-Funktion zuweisen. vorausgesetzt, das Skript gebunden an das Tabelle. Das folgende Beispiel zeigt, wie Sie dies einrichten.

  1. Wählen Sie in Google Tabellen den Menüpunkt Erweiterungen > aus. Apps Script zum Erstellen das an die Tabelle gebunden ist.
  2. Löschen Sie jeglichen Code im Skripteditor und fügen Sie den unten angegebenen Code ein.

      function showMessageBox() {
        Browser.msgBox('You clicked it!');
      }
    
  3. Kehren Sie zu Google Tabellen zurück und fügen Sie ein Bild oder eine Zeichnung ein, indem Sie Einfügen > Bild oder Einfügen > Zeichnung:

  4. Klicken Sie nach dem Einfügen des Bildes oder der Zeichnung darauf. Oben rechts wird ein kleines Drop-down-Menü angezeigt. Klicken Sie darauf und wählen Sie Script zuweisen:

  5. Geben Sie im angezeigten Dialogfeld den Namen der Apps Script-Funktion ein. die ohne Klammern ausgeführt werden sollen, in diesem Fall showMessageBox. Klicken Sie auf OK.

  6. Klicken Sie noch einmal auf das Bild oder die Zeichnung. Die Funktion wird jetzt ausgeführt.