Class CheckboxGridItem

Pole wyboru w siatce

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

MetodaZwracany typKrótki opis
clearValidation()CheckboxGridItemUsuwa wszystkie zatwierdzenia danych dla tego elementu siatki.
createResponse(responses)ItemResponseTworzy nowy element: ItemResponse dla tego elementu siatki.
duplicate()CheckboxGridItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getColumns()String[]Pobiera wartości dla każdej kolumny w siatce.
getHelpText()StringPobiera tekst pomocy elementu (czasem nazywany tekstem opisu dla elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu do wszystkich elementów w formularzu.
getRows()String[]Pobiera wartości dla każdego wiersza w siatce.
getTitle()StringPobiera tytuł elementu (czasem nazywany tekstem nagłówka, w przypadku SectionHeaderItem).
getType()ItemTypePobiera typ elementu reprezentowany jako ItemType.
isRequired()BooleanOkreśla, czy respondent musi odpowiedzieć na pytanie.
setColumns(columns)CheckboxGridItemUstawia kolumny siatki na podstawie tablicy wartości.
setHelpText(text)CheckboxGridItemUstawia tekst pomocy elementu (czasem nazywany tekstem opisu dla elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setRequired(enabled)CheckboxGridItemOkreśla, czy respondent musi odpowiedzieć na pytanie.
setRows(rows)CheckboxGridItemUstawia wiersze siatki na podstawie tablicy wartości.
setTitle(title)CheckboxGridItemUstawia tytuł elementu (czasem nazywany tekstem nagłówka, w przypadku SectionHeaderItem).
setValidation(validation)CheckboxGridItemUstawia 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

NazwaTypOpis
responsesString[][]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()

Pobiera typ elementu reprezentowany jako ItemType.

Zwróć

ItemType – typ produktu

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

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

NazwaTypOpis
columnsString[]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

NazwaTypOpis
textStringnowy 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

NazwaTypOpis
enabledBooleanczy 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

NazwaTypOpis
rowsString[]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

NazwaTypOpis
titleStringnowego 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

NazwaTypOpis
validationCheckboxGridValidationWeryfikację 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