Class Browser

Przeglądarka

Te zajęcia zapewniają dostęp do okien dialogowych typowych dla Arkuszy Google.

Metody z tej klasy są dostępne tylko w kontekście arkusza kalkulacyjnego Google. Zamiast niego używaj okna dialogowego Google Workspace.

Zobacz też

Właściwości

WłaściwośćTypOpis
ButtonsButtonSet

Metody

MetodaZwracany typKrótki opis
inputBox(prompt)StringWyświetla okno dialogowe z polem do wprowadzania tekstu w przeglądarce użytkownika.
inputBox(prompt, buttons)StringWyświetla okno dialogowe z polem do wprowadzania tekstu w przeglądarce użytkownika.
inputBox(title, prompt, buttons)StringWyświetla okno dialogowe z polem do wprowadzania tekstu w przeglądarce użytkownika.
msgBox(prompt)StringWyświetla okno z podaną wiadomością i przyciskiem OK w przeglądarce użytkownika.
msgBox(prompt, buttons)StringWyświetla okno z podaną wiadomością i określonymi przyciskami w przeglądarce użytkownika.
msgBox(title, prompt, buttons)StringWyświetla okno dialogowe z podanym tytułem, komunikatem i określonymi przyciskami w przeglądarce użytkownika.

Szczegółowa dokumentacja

inputBox(prompt)

Wyświetla okno dialogowe z polem do wprowadzania tekstu w przeglądarce użytkownika.

Metoda entryBox wyświetla pole do wprowadzania danych po stronie klienta, w którym wyświetlany jest dany prompt użytkownikowi. Pamiętaj, że ta funkcja powoduje zawieszenie skryptu po stronie serwera. Wznowienie jest automatycznie wznawiane po wyczyszczeniu okna przez użytkownika, ale połączenia JDBC nie są trwałe. 

// The code below sets the value of name to the name input by the user, or 'cancel'.
var name = Browser.inputBox('Enter your name');
Ta metoda nie jest zalecana. Zamiast tego użyj podpowiedzi interfejsu.

Parametry

NazwaTypOpis
promptStringTekst, który będzie wyświetlany w oknie dialogowym.

Powroty

String – tekst wpisany przez użytkownika (lub „Anuluj” w przypadku anulowanego lub zamkniętego okna).

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

inputBox(prompt, buttons)

Wyświetla okno dialogowe z polem do wprowadzania tekstu w przeglądarce użytkownika.

Metoda entryBox tworzy okno do wprowadzania danych po stronie klienta, w którym wyświetlany jest dany prompt, oraz umożliwia wybór przycisków do wyświetlenia. Pamiętaj, że ta funkcja powoduje zawieszenie skryptu po stronie serwera. Wznowienie jest automatycznie wznawiane po wyczyszczeniu okna przez użytkownika, ale połączenia JDBC nie są trwałe. 

// 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);
Ta metoda nie jest zalecana. Zamiast tego użyj podpowiedzi interfejsu.

Parametry

NazwaTypOpis
promptStringTekst, który będzie wyświetlany w oknie dialogowym.
buttonsButtonSetTyp przycisku ustawionego do użycia.

Powroty

String – tekst wpisany przez użytkownika (lub „Anuluj” w przypadku anulowanego lub zamkniętego okna).

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

inputBox(title, prompt, buttons)

Wyświetla okno dialogowe z polem do wprowadzania tekstu w przeglądarce użytkownika.

Metoda entryBox tworzy okno do wprowadzania danych po stronie klienta z podanym tytułem, w którym wyświetlany jest monit, wraz z przyciskami do wyświetlenia. Pamiętaj, że ta funkcja powoduje zawieszenie skryptu po stronie serwera. Wznowienie jest automatycznie wznawiane po wyczyszczeniu okna przez użytkownika, ale połączenia JDBC nie są pozostawiane w okresie zawieszenia. 

// 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);
Ta metoda nie jest zalecana. Zamiast tego użyj podpowiedzi interfejsu.

Parametry

NazwaTypOpis
titleStringTytuł okna dialogowego.
promptStringTekst, który będzie wyświetlany w oknie dialogowym.
buttonsButtonSetTyp przycisku ustawionego do użycia.

Powroty

String – tekst wpisany przez użytkownika (lub „Anuluj” w przypadku anulowanego lub zamkniętego okna).

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

msgBox(prompt)

Wyświetla okno z podaną wiadomością i przyciskiem OK w przeglądarce użytkownika.

Metoda msgBox wyświetla pole wiadomości po stronie klienta, które wyświetla daną wiadomość użytkownikowi. Pamiętaj, że ta metoda powoduje zawieszenie skryptu po stronie serwera. Wznowienie jest automatycznie wznawiane po wyczyszczeniu okna przez użytkownika, ale połączenia JDBC nie są trwałe. 

// The code below displays "hello world" in a dialog box with an OK button
Browser.msgBox('hello world');
Ta metoda nie jest zalecana. Zamiast tego użyj okna alertu interfejsu.

Parametry

NazwaTypOpis
promptStringTekst, który będzie wyświetlany w oknie dialogowym.

Powroty

String – mały tekst przycisku kliknięty przez użytkownika (lub „Anuluj” w przypadku zamkniętego okna).

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

msgBox(prompt, buttons)

Wyświetla okno z podaną wiadomością i określonymi przyciskami w przeglądarce użytkownika.

Metoda msgBox tworzy okno wiadomości po stronie klienta, w którym wyświetla się dana wiadomość użytkownikowi, i oferuje wybór przycisków do wyświetlenia. Pamiętaj, że ta metoda powoduje zawieszenie skryptu po stronie serwera. Wznowienie jest automatycznie wznawiane po wyczyszczeniu okna przez użytkownika, ale połączenia JDBC nie są trwałe. 

// The code below displays "hello world" in a dialog box with OK and Cancel buttons.
Browser.msgBox('hello world', Browser.Buttons.OK_CANCEL);
Ta metoda nie jest zalecana. Zamiast tego użyj okna alertu interfejsu.

Parametry

NazwaTypOpis
promptStringTekst, który będzie wyświetlany w oknie dialogowym.
buttonsButtonSetTyp przycisku ustawionego do użycia.

Powroty

String – mały tekst przycisku kliknięty przez użytkownika (lub „Anuluj” w przypadku zamkniętego okna).

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

msgBox(title, prompt, buttons)

Wyświetla okno dialogowe z podanym tytułem, komunikatem i określonymi przyciskami w przeglądarce użytkownika.

Metoda msgBox tworzy po stronie klienta pole wiadomości z podanym tytułem, w którym wyświetla się wiadomość podana użytkownikowi i oferuje wybór przycisków do wyświetlenia. Pamiętaj, że ta metoda powoduje zawieszenie skryptu po stronie serwera. Wznowienie jest automatycznie wznawiane po wyczyszczeniu okna przez użytkownika, ale połączenia JDBC nie są pozostawiane w okresie zawieszenia. 

// 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);
Ta metoda nie jest zalecana. Zamiast tego użyj okna alertu interfejsu.

Parametry

NazwaTypOpis
titleStringTytuł okna dialogowego.
promptStringTekst, który będzie wyświetlany w oknie dialogowym.
buttonsButtonSetTyp przycisku ustawionego do użycia.

Powroty

String – mały tekst przycisku kliknięty przez użytkownika (lub „Anuluj” w przypadku zamkniętego okna).

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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