Class CheckboxGridItem

CheckboxGridItem

Pytanie w formie siatki kolumn i wierszy, które umożliwia użytkownikowi wybranie wielu opcji w każdym wierszu z ciągu pól wyboru. Dostęp do elementów można uzyskać lub tworzyć je z poziomu 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

MetodaZwracany typKrótki opis
clearValidation()CheckboxGridItemUsuwa sprawdzanie poprawności danych w tym elemencie siatki.
createResponse(responses)ItemResponseTworzy nowy element ItemResponse dla tego elementu siatki pól wyboru.
duplicate()CheckboxGridItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getColumns()String[]Pobiera wartości z każdej kolumny w siatce.
getHelpText()StringPobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów w formularzu.
getRows()String[]Pobiera wartości z każdego wiersza w siatce.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
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 dotyczący elementu (czasami nazywany tekstem opisu w przypadku 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 (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
setValidation(validation)CheckboxGridItemUstawia sprawdzanie poprawności danych dla tego elementu siatki pól wyboru.

Szczegółowa dokumentacja

clearValidation()

Usuwa sprawdzanie poprawności danych w tym elemencie siatki.

Powrót

CheckboxGridItem – ten element, do łączenia w łańcuch

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 pól wyboru. Argument responses musi być String[][] tablicą tablic zawierającą tyle wartości, ile jest danych wejściowych w siatce pól wyboru. Element null w przypadku pytania z siatką pól wyboru, które nie jest wymagane, oznacza brak odpowiedzi w danym wierszu. Zgłasza wyjątek, jeśli któraś z wartości nie pasuje do prawidłowego wyboru.

Parametry

NazwaTypOpis
responsesString[][]tablica tablic prawidłowych odpowiedzi na to pytanie z siatką pól wyboru.

Powrót

ItemResponse – odpowiedź dotycząca elementu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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.

Powrót

CheckboxGridItem – duplikat tego CheckboxGridItem do łączenia

Autoryzacja

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

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

getColumns()

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 korzystające z tej metody wymagają autoryzacji z użyciem 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 (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Powrót

String – tekst pomocy lub opis elementu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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.

Powrót

Integer – identyfikator produktu;

Autoryzacja

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

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

getIndex()

Pobiera indeks elementu spośród wszystkich elementów w formularzu.

Powrót

Integer – indeks elementu;

Autoryzacja

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

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

getRows()

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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

getTitle()

Pobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

Powrót

String – tytuł lub tekst nagłówka produktu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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.

Powrót

ItemType – typ produktu

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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.

Powrót

Boolean – czy respondent musi odpowiedzieć na pytanie;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 podana tablica jest pusta.

Parametry

NazwaTypOpis
columnsString[]tablica wartości kolumn, które respondenci widzą jako etykiety podczas wyświetlania formularza.

Powrót

CheckboxGridItem – ten element, do łączenia w łańcuch

Rzuty

Error – jeśli podana tablica to null lub jest pusta.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Parametry

NazwaTypOpis
textStringnowy tekst pomocy,

Powrót

CheckboxGridItem – ten CheckboxGridItem do łączenia

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 respondent musi odpowiedzieć na pytanie;

Powrót

CheckboxGridItem – bieżący element (do łączenia w łańcuch)

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 podana tablica jest pusta.

Parametry

NazwaTypOpis
rowsString[]tablica wartości wierszy, które respondenci widzą jako etykiety podczas wyświetlania formularza;

Powrót

CheckboxGridItem – ten element, do łączenia w łańcuch

Rzuty

Error – jeśli podana tablica to null lub jest pusta.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

Parametry

NazwaTypOpis
titleStringnowy tytuł lub tekst nagłówka;

Powrót

CheckboxGridItem – ten CheckboxGridItem do łączenia

Autoryzacja

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

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

setValidation(validation)

Ustawia sprawdzanie poprawności danych dla tego elementu siatki pól wyboru. Przekazanie wartości null lub walidatora bez wywołania żadnych wymaganych funkcji spowoduje usunięcie wcześniejszej weryfikacji.

Parametry

NazwaTypOpis
validationCheckboxGridValidationobiekt CheckboxGridValidation, który ma być zastosowany do tego elementu.

Powrót

CheckboxGridItem – ten CheckboxGridItem do łączenia

Autoryzacja

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

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