Class Browser

Przeglądarka

Ta klasa zapewnia dostęp do okien dialogowych specyficznych dla Arkuszy Google.

Metody w tej klasie są dostępne tylko w kontekście arkusza kalkulacyjnego Google. Zamiast tego używaj okien Google Workspace.

Zobacz też

Właściwości

WłaściwośćTypOpis
ButtonsButtonSet

Metody

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

Szczegółowa dokumentacja

inputBox(prompt)

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

Metoda inputBox wyświetla po stronie klienta pole wprowadzania, w którym użytkownikowi wyświetla się podany prompt. Pamiętaj, że ta funkcja powoduje zawieszenie skryptu po stronie serwera. Wznawia się automatycznie po zamknięciu okna przez użytkownika, ale połączenia JDBC nie są zachowywane podczas zawieszenia. 

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox('Enter your name');
 Nie zalecamy tej metody. Zamiast tego użyj promptu interfejsu.

Parametry

NazwaTypOpis
promptStringTekst, który ma być wyświetlany w oknie dialogowym.

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

inputBox(prompt, buttons)

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

Metoda inputBox wyświetla po stronie klienta pole wprowadzania tekstu, w którym użytkownikowi wyświetlany jest podany prompt, oraz oferuje wybór przycisków do wyświetlenia. Pamiętaj, że ta funkcja powoduje zawieszenie skryptu po stronie serwera. Wznawia się automatycznie po zamknięciu okna przez użytkownika, ale połączenia JDBC nie są zachowywane podczas zawieszenia. 

// 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);
 Nie zalecamy tej metody. Zamiast tego użyj promptu interfejsu.

Parametry

NazwaTypOpis
promptStringTekst, który ma być wyświetlany w oknie dialogowym.
buttonsButtonSetTyp zestawu przycisków, który ma być używany.

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

inputBox(title, prompt, buttons)

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

Metoda inputBox wyświetla po stronie klienta pole wprowadzania z podanym tytułem, które wyświetla użytkownikowi podany prompt i oferuje wybór przycisków do wyświetlenia. Pamiętaj, że ta funkcja powoduje zawieszenie skryptu po stronie serwera. Po zamknięciu okna przez użytkownika wznawia się automatycznie, ale połączenia JDBC nie są zachowywane podczas zawieszenia. 

// 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,
);
 Nie zalecamy tej metody. Zamiast tego użyj promptu interfejsu.

Parametry

NazwaTypOpis
titleStringTytuł okna.
promptStringTekst, który ma być wyświetlany w oknie dialogowym.
buttonsButtonSetTyp zestawu przycisków, który ma być używany.

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

msgBox(prompt)

Wyświetla w przeglądarce użytkownika okno z podanym komunikatem i przyciskiem OK.

Metoda msgBox wyświetla po stronie klienta okno komunikatu z podaną wiadomością. Pamiętaj, że ta metoda powoduje zawieszenie skryptu po stronie serwera. Wznawia się automatycznie po zamknięciu okna przez użytkownika, ale połączenia JDBC nie są zachowywane podczas zawieszenia. 

// The code below displays "hello world" in a dialog box with an OK button
Browser.msgBox('hello world');
 Nie zalecamy tej metody. Zamiast tego użyj okna alertu interfejsu.

Parametry

NazwaTypOpis
promptStringTekst, który ma być wyświetlany w oknie dialogowym.

Powrót

String|null – tekst przycisku w małych literach, który został kliknięty przez użytkownika (lub „cancel” w przypadku zamknięcia okna).

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

msgBox(prompt, buttons)

Wyświetla w przeglądarce użytkownika okno z podanym komunikatem i określonymi przyciskami.

Metoda msgBox wyświetla po stronie klienta okno komunikatu, które zawiera podaną wiadomość i oferuje użytkownikowi wybór przycisków. Pamiętaj, że ta metoda powoduje zawieszenie skryptu po stronie serwera. Wznawia się automatycznie po zamknięciu okna przez użytkownika, ale połączenia JDBC nie są zachowywane podczas zawieszenia. 

// The code below displays "hello world" in a dialog box with OK and Cancel
// buttons.
Browser.msgBox('hello world', Browser.Buttons.OK_CANCEL);
 Nie zalecamy tej metody. Zamiast tego użyj okna alertu interfejsu.

Parametry

NazwaTypOpis
promptStringTekst, który ma być wyświetlany w oknie dialogowym.
buttonsButtonSetTyp zestawu przycisków, który ma być używany.

Powrót

String|null – tekst przycisku w małych literach, który został kliknięty przez użytkownika (lub „cancel” w przypadku zamknięcia okna).

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

msgBox(title, prompt, buttons)

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

Metoda msgBox wyświetla po stronie klienta okno komunikatu o podanym tytule, które zawiera podany komunikat dla użytkownika i oferuje wybór przycisków do wyświetlenia. Pamiętaj, że ta metoda powoduje zawieszenie skryptu po stronie serwera. Po zamknięciu okna przez użytkownika wznawia się automatycznie, ale połączenia JDBC nie są zachowywane podczas 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);
 Nie zalecamy tej metody. Zamiast tego użyj okna alertu interfejsu.

Parametry

NazwaTypOpis
titleStringTytuł okna.
promptStringTekst, który ma być wyświetlany w oknie dialogowym.
buttonsButtonSetTyp zestawu przycisków, który ma być używany.

Powrót

String|null – tekst przycisku w małych literach, który został kliknięty przez użytkownika (lub „cancel” w przypadku zamknięcia okna).

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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