Class Browser

Przeglądarka

Ta klasa zapewnia dostęp do okien dialogowych dotyczących Arkuszy Google.

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

Zobacz też

Właściwości

WłaściwośćTypOpis
ButtonsButtonSet

Metody

MetodaZwracany typKrótki opis
inputBox(prompt)StringW przeglądarce użytkownika wyświetla okno z polem tekstowym.
inputBox(prompt, buttons)StringW przeglądarce użytkownika wyświetla okno z polem tekstowym.
inputBox(title, prompt, buttons)StringW przeglądarce użytkownika wyświetla okno z polem tekstowym.
msgBox(prompt)StringWyświetla w przeglądarce użytkownika okno z określonym komunikatem i przyciskiem OK.
msgBox(prompt, buttons)Stringwyświetla w przeglądarce użytkownika okno z określonym komunikatem i określonymi przyciskami.
msgBox(title, prompt, buttons)StringW przeglądarce użytkownika wyświetla okno z określonym tytułem, wiadomością i określonymi przyciskami.

Szczegółowa dokumentacja

inputBox(prompt)

W przeglądarce użytkownika wyświetla okno z polem tekstowym.

Metoda inputBox tworzy pole wejściowe po stronie klienta, które wyświetla użytkownikowi dany prompt. Pamiętaj, że ta funkcja powoduje zawieszenie skryptu po stronie serwera. Wątek wznawia się automatycznie po usunięciu przez użytkownika okna dialogowego, 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 w interfejsie użytkownika.

Parametry

NazwaTypOpis
promptStringTekst do wyświetlenia w oknie dialogowym.

Powrót

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

Autoryzacja

Skrypty, które korzystają 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)

W przeglądarce użytkownika wyświetla okno z polem tekstowym.

Metoda inputBox wywołuje pole wejściowe po stronie klienta, które wyświetla użytkownikowi dany prompt i oferuje wybór przycisków do wyświetlenia. Pamiętaj, że ta funkcja powoduje zawieszenie skryptu po stronie serwera. Wątek wznawia działanie automatycznie po usunięciu przez użytkownika okna dialogowego, 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 w interfejsie użytkownika.

Parametry

NazwaTypOpis
promptStringTekst do wyświetlenia w oknie dialogowym.
buttonsButtonSetTyp zestawu przycisków, którego chcesz użyć.

Powrót

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

Autoryzacja

Skrypty, które korzystają 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)

W przeglądarce użytkownika wyświetla okno z polem tekstowym.

Metoda inputBox wywołuje pole wejściowe po stronie klienta z podanym tytułem, które wyświetla użytkownikowi prompt i oferuje wybór przycisków do wyświetlenia. Pamiętaj, że ta funkcja powoduje zawieszenie skryptu po stronie serwera. Wątek wznawia działanie automatycznie po tym, jak użytkownik zamknie okno dialogowe, 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 w interfejsie użytkownika.

Parametry

NazwaTypOpis
titleStringTytuł okna.
promptStringTekst do wyświetlenia w oknie dialogowym.
buttonsButtonSetTyp zestawu przycisków, którego chcesz użyć.

Powrót

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

Autoryzacja

Skrypty, które korzystają 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 w przeglądarce użytkownika okno z określonym komunikatem i przyciskiem OK.

Metoda msgBox tworzy okno wiadomości po stronie klienta, które wyświetla daną wiadomość użytkownikowi. Pamiętaj, że ta metoda powoduje zawieszenie skryptu po stronie serwera. Wątek wznawia się automatycznie po usunięciu przez użytkownika okna dialogowego, 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 alertu w interfejsie użytkownika.

Parametry

NazwaTypOpis
promptStringTekst do wyświetlenia w oknie dialogowym.

Powrót

String – tekst w małej literze przycisku, który użytkownik klika (lub „anuluj” w przypadku zamkniętego okna).

Autoryzacja

Skrypty, które korzystają 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 w przeglądarce użytkownika okno z określonym komunikatem i określonymi przyciskami.

Metoda msgBox tworzy okno wiadomości po stronie klienta, które wyświetla daną wiadomość użytkownikowi i zawiera przyciski do wyboru. Pamiętaj, że ta metoda powoduje zawieszenie skryptu po stronie serwera. Wątek wznawia działanie automatycznie po usunięciu przez użytkownika okna dialogowego, 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 alertu w interfejsie użytkownika.

Parametry

NazwaTypOpis
promptStringTekst do wyświetlenia w oknie dialogowym.
buttonsButtonSetTyp zestawu przycisków, którego chcesz użyć.

Powrót

String – tekst w małej literze przycisku, który użytkownik klika (lub „anuluj” w przypadku zamkniętego okna).

Autoryzacja

Skrypty, które korzystają 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)

W przeglądarce użytkownika wyświetla okno z określonym tytułem, wiadomością i określonymi przyciskami.

Metoda msgBox tworzy okno z komunikatem po stronie klienta, które zawiera dany tytuł, wyświetla dany komunikat użytkownikowi i zawiera przyciski do wyboru. Pamiętaj, że ta metoda powoduje zawieszenie skryptu po stronie serwera. Wątek wznawia działanie automatycznie po tym, jak użytkownik zamknie okno dialogowe, 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 alertu w interfejsie użytkownika.

Parametry

NazwaTypOpis
titleStringTytuł okna
promptStringTekst do wyświetlenia w oknie dialogowym.
buttonsButtonSetTyp zestawu przycisków, którego chcesz użyć.

Powrót

String – tekst w małej literze przycisku, który użytkownik klika (lub „anuluj” w przypadku zamkniętego okna).

Autoryzacja

Skrypty, które korzystają 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