Diese Seite wurde von der Cloud Translation API übersetzt.

Class Browser

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

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

Weitere Informationen

ButtonSet

Attribute

Attribut	Typ	Beschreibung
`Buttons`	`ButtonSet`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`inputBox(prompt)`	`String`	Im Browser des Nutzers wird ein Dialogfeld mit einem Textfeld angezeigt.
`inputBox(prompt, buttons)`	`String`	Im Browser des Nutzers wird ein Dialogfeld mit einem Textfeld angezeigt.
`inputBox(title, prompt, buttons)`	`String`	Im Browser des Nutzers wird ein Dialogfeld mit einem Textfeld angezeigt.
`msgBox(prompt)`	`String`	Im Browser des Nutzers wird ein Dialogfeld mit der angegebenen Nachricht und einer Schaltfläche „OK“ angezeigt.
`msgBox(prompt, buttons)`	`String`	Im Browser des Nutzers wird ein Dialogfeld mit der angegebenen Nachricht und den angegebenen Schaltflächen angezeigt.
`msgBox(title, prompt, buttons)`	`String`	Im Browser des Nutzers wird ein Dialogfeld mit dem angegebenen Titel, der Nachricht und den angegebenen Schaltflächen angezeigt.

Detaillierte Dokumentation

`inputBox(prompt)`

Im Browser des Nutzers wird ein Dialogfeld mit einem Textfeld angezeigt.

Die Methode „inputBox“ ruft ein clientseitiges Eingabefeld auf, in dem der Nutzer den angegebenen Prompt sieht. Hinweis: Diese Funktion führt dazu, dass das serverseitige Script angehalten wird. Die Ausführung wird automatisch fortgesetzt, nachdem der Nutzer das Dialogfeld geschlossen hat. JDBC-Verbindungen bleiben jedoch während der Sperrung nicht 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

Name	Typ	Beschreibung
`prompt`	`String`	Der Text, der im Dialogfeld angezeigt werden soll.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`inputBox(prompt, buttons)`

Im Browser des Nutzers wird ein Dialogfeld mit einem Textfeld angezeigt.

Die Methode „inputBox“ ruft ein clientseitiges Eingabefeld auf, in dem der Nutzer den angegebenen Prompt sieht und eine Auswahl von Schaltflächen angezeigt wird. Beachten Sie, dass durch diese Funktion das serverseitige Script angehalten wird. Die Ausführung wird automatisch fortgesetzt, nachdem der Nutzer das Dialogfeld geschlossen hat. JDBC-Verbindungen bleiben jedoch während der Sperrung nicht 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

Name	Typ	Beschreibung
`prompt`	`String`	Der Text, der im Dialogfeld angezeigt werden soll.
`buttons`	`ButtonSet`	Der zu verwendende Schaltflächentyp.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`inputBox(title, prompt, buttons)`

Im Browser des Nutzers wird ein Dialogfeld mit einem Textfeld angezeigt.

Die Methode „inputBox“ ruft ein clientseitiges Eingabefeld mit dem angegebenen Titel auf, in dem dem Nutzer der angegebene Prompt angezeigt wird und eine Auswahl von Schaltflächen angezeigt wird. Beachten Sie, dass durch diese Funktion das serverseitige Script angehalten wird. Die Ausführung wird automatisch fortgesetzt, nachdem der Nutzer das Dialogfeld geschlossen hat. JDBC-Verbindungen bleiben jedoch während der Sperrung 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

Name	Typ	Beschreibung
`title`	`String`	Der Titel des Dialogfelds.
`prompt`	`String`	Der Text, der im Dialogfeld angezeigt werden soll.
`buttons`	`ButtonSet`	Der zu verwendende Schaltflächentyp.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`msgBox(prompt)`

Im Browser des Nutzers wird ein Dialogfeld mit der angegebenen Nachricht und einer Schaltfläche „OK“ angezeigt.

Die Methode „msgBox“ ruft ein clientseitiges Nachrichtenfeld auf, in dem die angegebene Nachricht angezeigt wird. Hinweis: Bei dieser Methode wird das serverseitige Script angehalten. Die Ausführung wird automatisch fortgesetzt, nachdem der Nutzer das Dialogfeld geschlossen hat. JDBC-Verbindungen bleiben jedoch während der Sperrung nicht 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-Benachrichtigungsfenster.

Parameter

Name	Typ	Beschreibung
`prompt`	`String`	Der Text, der im Dialogfeld angezeigt werden soll.

Rückflug

String: Der Text der Schaltfläche in Kleinbuchstaben, auf die der Nutzer klickt (oder „Abbrechen“ für ein geschlossenes Dialogfeld).

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`msgBox(prompt, buttons)`

Im Browser des Nutzers wird ein Dialogfeld mit der angegebenen Nachricht und den angegebenen Schaltflächen angezeigt.

Die Methode „msgBox“ ruft ein clientseitiges Nachrichtenfeld auf, in dem die angegebene Nachricht dem Nutzer angezeigt wird und eine Auswahl von Schaltflächen angezeigt wird. Beachten Sie, dass durch diese Methode das serverseitige Script angehalten wird. Die Ausführung wird automatisch fortgesetzt, nachdem der Nutzer das Dialogfeld geschlossen hat. JDBC-Verbindungen bleiben jedoch während der Sperrung 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 UI-Benachrichtigungsfenster.

Parameter

Name	Typ	Beschreibung
`prompt`	`String`	Der Text, der im Dialogfeld angezeigt werden soll.
`buttons`	`ButtonSet`	Der zu verwendende Schaltflächentyp.

Rückflug

String: Der Text der Schaltfläche in Kleinbuchstaben, auf die der Nutzer klickt (oder „Abbrechen“ für ein geschlossenes Dialogfeld).

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`msgBox(title, prompt, buttons)`

Im Browser des Nutzers wird ein Dialogfeld mit dem angegebenen Titel, der Nachricht und den angegebenen Schaltflächen angezeigt.

Die Methode „msgBox“ ruft ein clientseitiges Nachrichtenfeld mit dem angegebenen Titel auf, in dem die angegebene Nachricht angezeigt wird und eine Auswahl von Schaltflächen angezeigt wird. Hinweis: Bei dieser Methode wird das serverseitige Script angehalten. Die Ausführung wird automatisch fortgesetzt, nachdem der Nutzer das Dialogfeld geschlossen hat. JDBC-Verbindungen bleiben jedoch 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 UI-Benachrichtigungsfenster.

Parameter

Name	Typ	Beschreibung
`title`	`String`	Der Titel des Dialogfelds.
`prompt`	`String`	Der Text, der im Dialogfeld angezeigt werden soll.
`buttons`	`ButtonSet`	Der zu verwendende Schaltflächentyp.

Rückflug

String: Der Text der Schaltfläche in Kleinbuchstaben, auf die der Nutzer klickt (oder „Abbrechen“ für ein geschlossenes Dialogfeld).

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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