Element pytania w formie siatki kolumn i wierszy, który umożliwia użytkownikowi wybranie wielu opcji w wierszu. Elementy można otworzyć lub utworzyć w
Form
.
// Open a form by ID and add a new checkgox grid item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var 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 |
---|---|---|
clearValidation() | CheckboxGridItem | Usuwa wszystkie zatwierdzenia danych dla tego elementu siatki. |
createResponse(responses) | ItemResponse | Tworzy nowy element: ItemResponse dla tego elementu siatki. |
duplicate() | CheckboxGridItem | Tworzy kopię tego elementu i dołącza ją na końcu formularza. |
getColumns() | String[] | Pobiera wartości dla każdej kolumny w siatce. |
getHelpText() | String | Pobiera tekst pomocy elementu (czasem nazywany tekstem opisu dla elementów układu takich jak ImageItems , PageBreakItems i SectionHeaderItems ). |
getId() | Integer | Pobiera unikalny identyfikator elementu. |
getIndex() | Integer | Pobiera indeks elementu do wszystkich elementów w formularzu. |
getRows() | String[] | Pobiera wartości dla każdego wiersza w siatce. |
getTitle() | String | Pobiera tytuł elementu (czasem nazywany tekstem nagłówka, w przypadku SectionHeaderItem ). |
getType() | ItemType | Pobiera typ elementu reprezentowany jako ItemType . |
isRequired() | Boolean | Określa, czy respondent musi odpowiedzieć na pytanie. |
setColumns(columns) | CheckboxGridItem | Ustawia kolumny siatki na podstawie tablicy wartości. |
setHelpText(text) | CheckboxGridItem | Ustawia tekst pomocy elementu (czasem nazywany tekstem opisu dla elementów układu takich jak ImageItems , PageBreakItems i SectionHeaderItems ). |
setRequired(enabled) | CheckboxGridItem | Określa, czy respondent musi odpowiedzieć na pytanie. |
setRows(rows) | CheckboxGridItem | Ustawia wiersze siatki na podstawie tablicy wartości. |
setTitle(title) | CheckboxGridItem | Ustawia tytuł elementu (czasem nazywany tekstem nagłówka, w przypadku SectionHeaderItem ). |
setValidation(validation) | CheckboxGridItem | Ustawia weryfikację danych tego elementu siatki. |
Szczegółowa dokumentacja
clearValidation()
Usuwa wszystkie zatwierdzenia danych dla tego elementu siatki.
Zwróć
CheckboxGridItem
– ten produkt do łańcucha
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(responses)
Tworzy nowy element: ItemResponse
dla tego elementu siatki. Argument responses
musi być tablicą String[][]
tablicy, która zawiera tyle wartości, ile znajduje się danych wejściowych w siatce pola wyboru. Element null
niewymaganego pytania z polem wyboru wskazuje, że w tym wierszu nie ma odpowiedzi. Zwraca wyjątek, jeśli którakolwiek z wartości nie pasuje do prawidłowego wyboru.
Parametry
Nazwa | Typ | Opis |
---|---|---|
responses | String[][] | tablica tablicy prawidłowych odpowiedzi dla tego elementu siatki z polem wyboru |
Zwróć
ItemResponse
– odpowiedź elementu;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
Tworzy kopię tego elementu i dołącza ją na końcu formularza.
Zwróć
CheckboxGridItem
– duplikat pytania „CheckboxGridItem
” dotyczący łańcucha
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getColumns()
Pobiera wartości dla każdej kolumny w siatce.
Zwróć
String[]
– tablica wartości kolumn, które ankietowani widzą jako etykiety podczas przeglądania formularza;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getHelpText()
Pobiera tekst pomocy elementu (czasem nazywany tekstem opisu dla elementów układu takich jak ImageItems
, PageBreakItems
i SectionHeaderItems
).
Zwróć
String
– tekst pomocy lub opis elementu;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
Pobiera unikalny identyfikator elementu.
Zwróć
Integer
– identyfikator elementu;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getIndex()
Pobiera indeks elementu do wszystkich elementów w formularzu.
Zwróć
Integer
– indeks elementu
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getRows()
Pobiera wartości dla każdego wiersza w siatce.
Zwróć
String[]
– tablica wartości wierszy, które ankietowani widzą jako etykiety podczas przeglądania formularza;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
Pobiera tytuł elementu (czasem nazywany tekstem nagłówka, w przypadku SectionHeaderItem
).
Zwróć
String
– tytuł lub tekst nagłówka;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
isRequired()
Określa, czy respondent musi odpowiedzieć na pytanie.
Zwróć
Boolean
– czy użytkownik musi odpowiedzieć na pytanie;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setColumns(columns)
Ustawia kolumny siatki na podstawie tablicy wartości. Zwraca wyjątek, jeśli podany tablica jest pusty.
Parametry
Nazwa | Typ | Opis |
---|---|---|
columns | String[] | tablica wartości kolumn, które ankietowani widzą jako etykiety podczas przeglądania formularza; |
Zwróć
CheckboxGridItem
– ten produkt do łańcucha
Narzuty
Error
– jeśli podana tablica jest null
lub pusta
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
Ustawia tekst pomocy elementu (czasem nazywany tekstem opisu dla elementów układu takich jak ImageItems
, PageBreakItems
i SectionHeaderItems
).
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | nowy tekst pomocy |
Zwróć
CheckboxGridItem
– ten CheckboxGridItem
do łańcucha
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
Określa, czy respondent musi odpowiedzieć na pytanie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | czy użytkownik musi odpowiedzieć na pytanie; |
Zwróć
CheckboxGridItem
– bieżący element (łańcuch)
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRows(rows)
Ustawia wiersze siatki na podstawie tablicy wartości. Zwraca wyjątek, jeśli dana tablica jest pusta.
Parametry
Nazwa | Typ | Opis |
---|---|---|
rows | String[] | tablica wartości wierszy, które ankietowani widzą jako etykiety podczas przeglądania formularza; |
Zwróć
CheckboxGridItem
– ten produkt do łańcucha
Narzuty
Error
– jeśli podana tablica jest null
lub pusta
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
Ustawia tytuł elementu (czasem nazywany tekstem nagłówka, w przypadku SectionHeaderItem
).
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | nowego tytułu lub tekstu nagłówka, |
Zwróć
CheckboxGridItem
– ten CheckboxGridItem
do łańcucha
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
Ustawia weryfikację danych tego elementu siatki. Przekazywanie wartości null lub weryfikacji, która nie wymaga użycia funkcji, spowoduje usunięcie wcześniejszej weryfikacji.
Parametry
Nazwa | Typ | Opis |
---|---|---|
validation | CheckboxGridValidation | Weryfikację pól wyboru, która ma zostać zastosowana do tego elementu. |
Zwróć
CheckboxGridItem
– ten CheckboxGridItem
do łańcucha
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms