Class Browser

Browser

Diese Klasse bietet Zugriff auf Google Sheets-spezifische Dialogfelder.

Die Methoden in dieser Klasse können nur im Kontext einer Google-Tabelle verwendet werden. Verwenden Sie stattdessen Google Workspace-Dialogfelder.

Weitere Informationen

Attribute

AttributTypBeschreibung
ButtonsButtonSet

Methoden

MethodeRückgabetypKurzbeschreibung
inputBox(prompt)String|nullEs wird ein Dialogfeld mit einem Texteingabefeld im Browser des Nutzers eingeblendet.
inputBox(prompt, buttons)String|nullEs wird ein Dialogfeld mit einem Texteingabefeld im Browser des Nutzers eingeblendet.
inputBox(title, prompt, buttons)String|nullEs wird ein Dialogfeld mit einem Texteingabefeld im Browser des Nutzers eingeblendet.
msgBox(prompt)String|nullEs wird ein Dialogfeld mit der angegebenen Nachricht und einer Schaltfläche „OK“ im Browser des Nutzers eingeblendet.
msgBox(prompt, buttons)String|nullEs wird ein Dialogfeld mit der angegebenen Nachricht und den angegebenen Schaltflächen im Browser des Nutzers eingeblendet.
msgBox(title, prompt, buttons)String|nullEs wird ein Dialogfeld mit dem angegebenen Titel, der Nachricht und den angegebenen Schaltflächen im Browser des Nutzers eingeblendet.

Detaillierte Dokumentation

inputBox(prompt)

Es wird ein Dialogfeld mit einem Texteingabefeld im Browser des Nutzers eingeblendet.

Die Methode „inputBox“ öffnet ein clientseitiges Eingabefeld, in dem der angegebene Prompt für den Nutzer angezeigt wird. Diese Funktion führt dazu, dass das serverseitige Skript angehalten wird. Die Ausführung wird automatisch fortgesetzt, nachdem der Nutzer das Dialogfeld geschlossen hat. JDBC-Verbindungen bleiben jedoch nicht über die Unterbrechung hinweg bestehen. 

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox('Enter your name');
 Diese Methode wird nicht empfohlen. Verwenden Sie stattdessen einen UI-Prompt.

Parameter

NameTypBeschreibung
promptStringDer Text, der im Dialogfeld angezeigt werden soll.

Rückflug

String|null: Der vom Nutzer eingegebene Text (oder „cancel“ für ein abgebrochenes oder geschlossenes Dialogfeld).

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

inputBox(prompt, buttons)

Es wird ein Dialogfeld mit einem Texteingabefeld im Browser des Nutzers eingeblendet.

Mit der Methode „inputBox“ wird ein clientseitiges Eingabefeld aufgerufen, in dem der angegebene Prompt für den Nutzer angezeigt wird. Außerdem wird eine Auswahl von Schaltflächen angeboten, die angezeigt werden sollen. Beachten Sie, dass diese Funktion dazu führt, dass das serverseitige Skript angehalten wird. Die Ausführung wird automatisch fortgesetzt, nachdem der Nutzer das Dialogfeld geschlossen hat. JDBC-Verbindungen bleiben jedoch nicht über die Unterbrechung hinweg bestehen. 

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox('Enter your name', Browser.Buttons.OK_CANCEL);
 Diese Methode wird nicht empfohlen. Verwenden Sie stattdessen einen UI-Prompt.

Parameter

NameTypBeschreibung
promptStringDer Text, der im Dialogfeld angezeigt werden soll.
buttonsButtonSetDer Typ der Schaltflächengruppe, die verwendet werden soll.

Rückflug

String|null: Der vom Nutzer eingegebene Text (oder „cancel“ für ein abgebrochenes oder geschlossenes Dialogfeld).

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

inputBox(title, prompt, buttons)

Es wird ein Dialogfeld mit einem Texteingabefeld im Browser des Nutzers eingeblendet.

Die Methode „inputBox“ öffnet ein Eingabefeld auf der Clientseite mit dem angegebenen Titel, in dem der angegebene Prompt für den Nutzer angezeigt wird. Außerdem werden Schaltflächen zur Auswahl angeboten. Beachten Sie, dass diese Funktion dazu führt, dass das serverseitige Skript angehalten wird. Die Verbindung wird automatisch fortgesetzt, nachdem der Nutzer das Dialogfeld geschlossen hat. JDBC-Verbindungen bleiben jedoch während der Unterbrechung nicht bestehen. 

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox(
    'ID Check',
    'Enter your name',
    Browser.Buttons.OK_CANCEL,
);
 Diese Methode wird nicht empfohlen. Verwenden Sie stattdessen einen UI-Prompt.

Parameter

NameTypBeschreibung
titleStringDer Titel des Dialogfelds.
promptStringDer Text, der im Dialogfeld angezeigt werden soll.
buttonsButtonSetDer Typ der Schaltflächengruppe, die verwendet werden soll.

Rückflug

String|null: Der vom Nutzer eingegebene Text (oder „cancel“ für ein abgebrochenes oder geschlossenes Dialogfeld).

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

msgBox(prompt)

Es wird ein Dialogfeld mit der angegebenen Nachricht und einer Schaltfläche „OK“ im Browser des Nutzers eingeblendet.

Die msgBox-Methode öffnet ein clientseitiges Meldungsfeld, in dem die angegebene Meldung für den Nutzer angezeigt wird. Beachten Sie, dass das serverseitige Skript durch diese Methode angehalten wird. Die Ausführung wird automatisch fortgesetzt, nachdem der Nutzer das Dialogfeld geschlossen hat. JDBC-Verbindungen bleiben jedoch nicht über die Unterbrechung hinweg bestehen. 

// The code below displays "hello world" in a dialog box with an OK button
Browser.msgBox('hello world');
 Diese Methode wird nicht empfohlen. Verwenden Sie stattdessen ein UI-Benachrichtigungsdialogfeld.

Parameter

NameTypBeschreibung
promptStringDer Text, der im Dialogfeld angezeigt werden soll.

Rückflug

String|null: Der Text der Schaltfläche, auf die der Nutzer geklickt hat (oder „cancel“ für ein geschlossenes Dialogfeld).

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

msgBox(prompt, buttons)

Es wird ein Dialogfeld mit der angegebenen Nachricht und den angegebenen Schaltflächen im Browser des Nutzers eingeblendet.

Die msgBox-Methode öffnet ein clientseitiges Meldungsfeld, in dem die angegebene Nachricht für den Nutzer angezeigt wird. Außerdem werden verschiedene Schaltflächen zur Auswahl angeboten. Beachten Sie, dass das serverseitige Skript durch diese Methode angehalten wird. Die Ausführung wird automatisch fortgesetzt, nachdem der Nutzer das Dialogfeld geschlossen hat. JDBC-Verbindungen bleiben jedoch nicht über die Unterbrechung hinweg bestehen. 

// The code below displays "hello world" in a dialog box with OK and Cancel
// buttons.
Browser.msgBox('hello world', Browser.Buttons.OK_CANCEL);
 Diese Methode wird nicht empfohlen. Verwenden Sie stattdessen ein UI-Benachrichtigungsdialogfeld.

Parameter

NameTypBeschreibung
promptStringDer Text, der im Dialogfeld angezeigt werden soll.
buttonsButtonSetDer Typ der Schaltflächengruppe, die verwendet werden soll.

Rückflug

String|null: Der Text der Schaltfläche, auf die der Nutzer geklickt hat (oder „cancel“ für ein geschlossenes Dialogfeld).

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

msgBox(title, prompt, buttons)

Es wird ein Dialogfeld mit dem angegebenen Titel, der Nachricht und den angegebenen Schaltflächen im Browser des Nutzers eingeblendet.

Die msgBox-Methode ruft ein clientseitiges Meldungsfeld mit dem angegebenen Titel auf, in dem die angegebene Nachricht für den Nutzer angezeigt wird. Außerdem wird eine Auswahl von Schaltflächen angeboten. Beachten Sie, dass diese Methode dazu führt, dass das serverseitige Skript angehalten wird. Die Verbindung wird automatisch fortgesetzt, nachdem der Nutzer das Dialogfeld geschlossen hat. JDBC-Verbindungen bleiben jedoch während der Unterbrechung nicht bestehen. 

// The code below displays "hello world" in a dialog box with a custom title and
// Yes and No buttons
Browser.msgBox('Greetings', 'hello world', Browser.Buttons.YES_NO);
 Diese Methode wird nicht empfohlen. Verwenden Sie stattdessen ein UI-Benachrichtigungsdialogfeld.

Parameter

NameTypBeschreibung
titleStringDer Titel des Dialogfelds.
promptStringDer Text, der im Dialogfeld angezeigt werden soll.
buttonsButtonSetDer Typ der Schaltflächengruppe, die verwendet werden soll.

Rückflug

String|null: Der Text der Schaltfläche, auf die der Nutzer geklickt hat (oder „cancel“ für ein geschlossenes Dialogfeld).

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets