Class Browser

Browser

Diese Klasse bietet Zugriff auf Dialogfelder speziell für Google Tabellen.

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Öffnet ein Dialogfeld mit einem Texteingabefeld im Browser des Nutzers.
inputBox(prompt, buttons)StringÖffnet ein Dialogfeld mit einem Texteingabefeld im Browser des Nutzers.
inputBox(title, prompt, buttons)StringÖffnet ein Dialogfeld mit einem Texteingabefeld im Browser des Nutzers.
msgBox(prompt)StringÖffnet ein Dialogfeld mit der entsprechenden Meldung und der Schaltfläche „OK“ im Browser des Nutzers.
msgBox(prompt, buttons)StringÖffnet ein Dialogfeld mit der entsprechenden Meldung und den angegebenen Schaltflächen im Browser des Nutzers.
msgBox(title, prompt, buttons)StringÖffnet ein Dialogfeld mit dem jeweiligen Titel, der Meldung und den angegebenen Schaltflächen im Browser des Nutzers.

Detaillierte Dokumentation

inputBox(prompt)

Öffnet ein Dialogfeld mit einem Texteingabefeld im Browser des Nutzers.

Die InputBox-Methode löst ein clientseitiges Eingabefeld aus, in dem der angegebene Prompt im Nutzer. Beachten Sie, dass diese Funktion dazu führt, dass das serverseitige Skript ausgesetzt wird. Sie wird fortgesetzt nachdem der Nutzer das Dialogfeld geschlossen hat, aber JDBC-Verbindungen über den gesamten Sperrung.

// The code below sets the value of name to the name input by the user, or 'cancel'.
var name = Browser.inputBox('Enter your name');
Diese Methode wird nicht empfohlen. Verwenden Sie stattdessen eine Eingabeaufforderung auf der Benutzeroberfläche.

Parameter

NameTypBeschreibung
promptStringText, der im Dialogfeld angezeigt werden soll.

Rückflug

String: Der vom Nutzer eingegebene Text oder „Abbrechen“, wenn ein Dialogfeld abgebrochen oder geschlossen wurde.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

inputBox(prompt, buttons)

Öffnet ein Dialogfeld mit einem Texteingabefeld im Browser des Nutzers.

Die InputBox-Methode löst ein clientseitiges Eingabefeld aus, in dem der angegebene Prompt im Nutzer und bietet eine Auswahl an anzuzeigenden Schaltflächen. Beachten Sie, dass diese Funktion serverseitiges Script gesperrt werden. Sie wird automatisch fortgesetzt, wenn der Nutzer das Dialogfeld schließt, JDBC-Verbindungen bleiben während der Sperrzeit jedoch nicht bestehen.

// The code below sets the value of name to the name input by the user, or 'cancel'.
var name = Browser.inputBox('Enter your name', Browser.Buttons.OK_CANCEL);
Diese Methode wird nicht empfohlen. Verwenden Sie stattdessen eine Eingabeaufforderung auf der Benutzeroberfläche.

Parameter

NameTypBeschreibung
promptStringText, der im Dialogfeld angezeigt werden soll.
buttonsButtonSetDie Art der zu verwendenden Schaltfläche.

Rückflug

String: Der vom Nutzer eingegebene Text oder „Abbrechen“, wenn ein Dialogfeld abgebrochen oder geschlossen wurde.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

inputBox(title, prompt, buttons)

Öffnet ein Dialogfeld mit einem Texteingabefeld im Browser des Nutzers.

Die Methode "inputBox" löst ein clientseitiges Eingabefeld mit dem angegebenen Titel aus, in dem die Aufforderung an den Nutzer und bietet eine Auswahl an anzuzeigenden Schaltflächen. Beachten Sie, dass dies -Funktion führt dazu, dass das serverseitige Skript ausgesetzt wird. Sie wird automatisch fortgesetzt, löscht das Dialogfeld, aber JDBC-Verbindungen bleiben während der Sperrung nicht bestehen.

// The code below sets the value of name to the name input by the user, or 'cancel'.
var name = Browser.inputBox('ID Check', 'Enter your name', Browser.Buttons.OK_CANCEL);
Diese Methode wird nicht empfohlen. Verwenden Sie stattdessen eine Eingabeaufforderung auf der Benutzeroberfläche.

Parameter

NameTypBeschreibung
titleStringDer Titel des Dialogfelds.
promptStringText, der im Dialogfeld angezeigt werden soll.
buttonsButtonSetDie Art der zu verwendenden Schaltfläche.

Rückflug

String: Der vom Nutzer eingegebene Text oder „Abbrechen“, wenn ein Dialogfeld abgebrochen oder geschlossen wurde.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

msgBox(prompt)

Öffnet ein Dialogfeld mit der entsprechenden Meldung und der Schaltfläche „OK“ im Browser des Nutzers.

Die msgBox-Methode löst ein clientseitiges Nachrichtenfeld aus, in dem die gegebene Nachricht an die Nutzer. Beachten Sie, dass diese Methode dazu führt, dass das serverseitige Skript ausgesetzt wird. Sie wird fortgesetzt nachdem der Nutzer das Dialogfeld geschlossen hat, aber JDBC-Verbindungen über den gesamten Sperrung.

// 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 Dialogfeld mit einer Benachrichtigung über die Benutzeroberfläche.

Parameter

NameTypBeschreibung
promptStringText, der im Dialogfeld angezeigt werden soll.

Rückflug

String: Der kleingeschriebene Text der Schaltfläche, auf die der Nutzer klickt, oder „Abbrechen“ für einen Dialogfeld geschlossen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

msgBox(prompt, buttons)

Öffnet ein Dialogfeld mit der entsprechenden Meldung und den angegebenen Schaltflächen im Browser des Nutzers.

Die msgBox-Methode löst ein clientseitiges Nachrichtenfeld aus, in dem die gegebene Nachricht an die Nutzer und bietet eine Auswahl an anzuzeigenden Schaltflächen. Beachten Sie, dass diese Methode den serverseitiges Script gesperrt werden. Sie wird automatisch fortgesetzt, wenn der Nutzer das Dialogfeld schließt, JDBC-Verbindungen bleiben während der Sperrzeit jedoch nicht 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 Dialogfeld mit einer Benachrichtigung über die Benutzeroberfläche.

Parameter

NameTypBeschreibung
promptStringText, der im Dialogfeld angezeigt werden soll.
buttonsButtonSetDie Art der zu verwendenden Schaltfläche.

Rückflug

String: Der kleingeschriebene Text der Schaltfläche, auf die der Nutzer klickt, oder „Abbrechen“ für einen Dialogfeld geschlossen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

msgBox(title, prompt, buttons)

Öffnet ein Dialogfeld mit dem jeweiligen Titel, der Meldung und den angegebenen Schaltflächen im Browser des Nutzers.

Die msgBox-Methode löst ein clientseitiges Nachrichtenfeld mit dem angegebenen Titel aus, in dem die eine Nachricht an den Nutzer und bietet eine Auswahl an anzuzeigenden Schaltflächen. Beachten Sie, dass dies wird das serverseitige Skript angehalten. Sie wird automatisch fortgesetzt, löscht das Dialogfeld, aber JDBC-Verbindungen bleiben während der Sperrung 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 Dialogfeld mit einer Benachrichtigung über die Benutzeroberfläche.

Parameter

NameTypBeschreibung
titleStringDer Titel des Dialogfelds.
promptStringText, der im Dialogfeld angezeigt werden soll.
buttonsButtonSetDie Art der zu verwendenden Schaltfläche.

Rückflug

String: Der kleingeschriebene Text der Schaltfläche, auf die der Nutzer klickt, oder „Abbrechen“ für einen Dialogfeld geschlossen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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