Element w postaci siatki kolumn i wierszy, który umożliwia respondentowi wybranie kilku opcji w każdym wierszu z kolejnych pól wyboru. Elementy można tworzyć i otwierać w folderze Form
.
// Open a form by ID and add a new checkbox grid item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addCheckboxGridItem(); item.setTitle('Where did you celebrate New Years?') .setRows(['New York', 'San Francisco', 'London']) .setColumns(['2014', '2015', '2016', '2017']);
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
clear | Checkbox | Usuwa wszystkie reguły sprawdzania poprawności danych dotyczące tego elementu siatki. |
create | Item | Tworzy nowy element Item dla tego elementu siatki z polem wyboru. |
duplicate() | Checkbox | Tworzy kopię tego elementu i dodaje ją na końcu formularza. |
get | String[] | Pobiera wartości z każdej kolumny w siatce. |
get | String | Pobiera tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak Image , Page i Section ). |
get | Integer | Pobiera unikalny identyfikator produktu. |
get | Integer | Pobiera indeks elementu spośród wszystkich elementów w formularzu. |
get | String[] | Pobiera wartości z każdego wiersza w siatce. |
get | String | Pobiera tytuł elementu (czasami nazywany tekstem nagłówka w przypadku Section ). |
get | Item | Pobiera typ elementu jako Item . |
is | Boolean | Określa, czy respondent musi odpowiedzieć na pytanie. |
set | Checkbox | Ustawia kolumny siatki na podstawie tablicy wartości. |
set | Checkbox | Ustawia tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak Image , Page i Section ). |
set | Checkbox | Określa, czy respondent musi odpowiedzieć na pytanie. |
set | Checkbox | Ustawia wiersze siatki na podstawie tablicy wartości. |
set | Checkbox | Ustawia tytuł produktu (czasami nazywany tekstem nagłówka w przypadku Section ). |
set | Checkbox | Określa sprawdzanie poprawności danych dla tego elementu siatki z polem wyboru. |
Szczegółowa dokumentacja
clear Validation()
Usuwa wszystkie reguły sprawdzania poprawności danych dotyczące tego elementu siatki.
Powrót
Checkbox
– ten element, do łańcucha;
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
create Response(responses)
Tworzy nowy element Item
dla tego elementu siatki z polem wyboru. Argument responses
musi być tablicą String[][]
tablic zawierającą tyle wartości, ile jest elementów wejściowych w siatce z polami wyboru. Element null
w przypadku niewymaganego pytania z siatką pól wyboru wskazuje, że w danym wierszu nie ma odpowiedzi. Wyjątek jest zgłaszany, jeśli którakolwiek z wartości nie pasuje do prawidłowego wyboru.
Parametry
Nazwa | Typ | Opis |
---|---|---|
responses | String[][] | tablica tablic prawidłowych odpowiedzi dla tego elementu siatki pól wyboru |
Powrót
Item
– odpowiedź na element
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
Tworzy kopię tego elementu i dodaje ją na końcu formularza.
Powrót
Checkbox
– duplikat tego elementu Checkbox
, służący do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Columns()
Pobiera wartości z każdej kolumny w siatce.
Powrót
String[]
– tablica wartości kolumn, które respondenci widzą jako etykiety podczas wyświetlania formularza.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Help Text()
Pobiera tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak Image
, Page
i Section
).
Powrót
String
– tekst pomocy lub tekst opisu produktu,
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Id()
Pobiera unikalny identyfikator produktu.
Powrót
Integer
– identyfikator produktu
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Index()
Pobiera indeks elementu spośród wszystkich elementów w formularzu.
Powrót
Integer
– indeks elementu
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Rows()
Pobiera wartości z każdego wiersza w siatce.
Powrót
String[]
– tablica wartości wierszy, które respondenci widzą jako etykiety podczas wyświetlania formularza.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Title()
Pobiera tytuł elementu (czasami nazywany tekstem nagłówka w przypadku Section
).
Powrót
String
– tytuł lub tekst nagłówka
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Type()
is Required()
Określa, czy respondent musi odpowiedzieć na pytanie.
Powrót
Boolean
– czy respondent musi odpowiedzieć na pytanie
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Columns(columns)
Ustawia kolumny siatki na podstawie tablicy wartości. Wyjątek, jeśli podany tablica jest pusta.
Parametry
Nazwa | Typ | Opis |
---|---|---|
columns | String[] | tablica wartości kolumn, które respondenci widzą jako etykiety podczas wyświetlania formularza. |
Powrót
Checkbox
– ten element, do łańcucha;
Rzuty
Error
– jeśli podana tablica jest tablicą null
lub pusta
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Help Text(text)
Ustawia tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak Image
, Page
i Section
).
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | nowy tekst pomocy. |
Powrót
Checkbox
– ta Checkbox
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Required(enabled)
Określa, czy respondent musi odpowiedzieć na pytanie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | czy respondent musi udzielić odpowiedzi na pytanie. |
Powrót
Checkbox
– bieżący element (do łańcuchowania).
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Rows(rows)
Ustawia wiersze siatki na podstawie tablicy wartości. Wyjątek, jeśli podany tablica jest pusta.
Parametry
Nazwa | Typ | Opis |
---|---|---|
rows | String[] | tablica wartości wierszy, które respondenci widzą jako etykiety podczas wyświetlania formularza. |
Powrót
Checkbox
– ten element, do łańcucha;
Rzuty
Error
– jeśli podana tablica jest tablicą null
lub pusta
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Title(title)
Ustawia tytuł produktu (czasami nazywany tekstem nagłówka w przypadku Section
).
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | nowy tytuł lub tekst nagłówka. |
Powrót
Checkbox
– ta Checkbox
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Validation(validation)
Określa sprawdzanie poprawności danych dla tego elementu siatki z polem wyboru. Przekazanie wartości null lub walidacji bez wywołania funkcji wymagających spowoduje usunięcie wcześniejszej walidacji.
Parametry
Nazwa | Typ | Opis |
---|---|---|
validation | Checkbox | walidację CheckboxGridValidation, która ma być stosowana w przypadku tego elementu. |
Powrót
Checkbox
– ta Checkbox
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms