Diese Seite wurde von der Cloud Translation API übersetzt.

Class Browser

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

Die Methoden in dieser Klasse stehen nur für die Verwendung im Kontext einer Google-Tabelle zur Verfügung. Verwenden Sie stattdessen die Google Workspace-Dialogfelder.

Weitere Informationen

ButtonSet

Attribute

Property	Typ	Beschreibung
`Buttons`	`ButtonSet`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`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 angegebenen Meldung und einer OK-Schaltfläche im Browser des Nutzers.
`msgBox(prompt, buttons)`	`String`	Öffnet ein Dialogfeld mit der angegebenen Nachricht und angegebenen Schaltflächen im Browser des Nutzers.
`msgBox(title, prompt, buttons)`	`String`	Öffnet ein Dialogfeld mit dem angegebenen Titel, der Nachricht und den angegebenen Schaltflächen im Browser des Nutzers.

Detaillierte Dokumentation

`inputBox(prompt)`

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

Die Methode "inputBox" löst ein clientseitiges Eingabefeld aus, das dem Nutzer die angegebene Eingabeaufforderung anzeigt. Beachten Sie, dass diese Funktion dazu führt, dass das serverseitige Skript angehalten wird. Sie wird automatisch fortgesetzt, nachdem der Nutzer das Dialogfeld gelöscht hat, 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('Enter your name');

Diese Methode wird nicht empfohlen. Verwenden Sie stattdessen eine UI-Aufforderung.

Parameter

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

Return

String: der vom Nutzer eingegebene Text (oder „Abbrechen“ im Falle eines abgebrochenen oder geschlossenen Dialogfelds).

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 Methode inputBox löst ein clientseitiges Eingabefeld aus, das dem Nutzer die angegebene Eingabeaufforderung anzeigt und eine Auswahl von Schaltflächen anbietet, die angezeigt werden sollen. Beachten Sie, dass diese Funktion dazu führt, dass das serverseitige Skript angehalten wird. Sie wird automatisch fortgesetzt, nachdem der Nutzer das Dialogfeld geschlossen hat. JDBC-Verbindungen bleiben jedoch während der Sperrung 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 UI-Aufforderung.

Parameter

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

Return

String: der vom Nutzer eingegebene Text (oder „Abbrechen“ im Falle eines abgebrochenen oder geschlossenen Dialogfelds).

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, das dem Nutzer die entsprechende Eingabeaufforderung anzeigt und eine Auswahl an anzuzeigenden Schaltflächen bietet. Beachten Sie, dass diese Funktion dazu führt, dass das serverseitige Skript gesperrt wird. Sie wird automatisch fortgesetzt, nachdem der Nutzer das Dialogfeld geschlossen hat. JDBC-Verbindungen bleiben jedoch während der Sperrung 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 UI-Aufforderung.

Parameter

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

Return

String: der vom Nutzer eingegebene Text (oder „Abbrechen“ im Falle eines abgebrochenen oder geschlossenen Dialogfelds).

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 angegebenen Meldung und einer OK-Schaltfläche im Browser des Nutzers.

Die Methode msgBox löst ein clientseitiges Nachrichtenfeld aus, in dem dem Nutzer die angegebene Nachricht angezeigt wird. Beachten Sie, dass diese Methode dazu führt, dass das serverseitige Skript gesperrt wird. Sie wird automatisch fortgesetzt, nachdem der Nutzer das Dialogfeld gelöscht hat, aber JDBC-Verbindungen bleiben 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 Dialogfeld mit einer UI-Benachrichtigung.

Parameter

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

Return

String: Der kleingeschriebene Text der Schaltfläche, auf den der Nutzer klickt (oder „Abbrechen“ bei einem geschlossenen Dialogfeld).

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 angegebenen Nachricht und angegebenen Schaltflächen im Browser des Nutzers.

Mit der Methode msgBox wird ein clientseitiges Nachrichtenfeld ausgelöst, in dem dem Nutzer die jeweilige Nachricht angezeigt wird. Außerdem wird eine Auswahl an Schaltflächen zur Auswahl angeboten. Beachten Sie, dass diese Methode dazu führt, dass das serverseitige Skript gesperrt wird. Sie wird automatisch fortgesetzt, nachdem der Nutzer das Dialogfeld geschlossen hat. JDBC-Verbindungen bleiben jedoch während der Sperrung 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 UI-Benachrichtigung.

Parameter

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

Return

String: Der kleingeschriebene Text der Schaltfläche, auf den der Nutzer klickt (oder „Abbrechen“ bei einem geschlossenen Dialogfeld).

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 angegebenen Titel, der Nachricht und den angegebenen Schaltflächen im Browser des Nutzers.

Die msgBox-Methode löst ein clientseitiges Nachrichtenfeld mit dem angegebenen Titel aus, das dem Nutzer die jeweilige Nachricht anzeigt und eine Auswahl an anzuzeigenden Schaltflächen bietet. Beachten Sie, dass diese Methode dazu führt, dass das serverseitige Skript gesperrt wird. Sie wird automatisch fortgesetzt, nachdem der Nutzer das Dialogfeld geschlossen hat. JDBC-Verbindungen bleiben jedoch während der Sperrung 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 UI-Benachrichtigung.

Parameter

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

Return

String: Der kleingeschriebene Text der Schaltfläche, auf den der Nutzer klickt (oder „Abbrechen“ bei einem geschlossenen Dialogfeld).

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