Class CheckboxGridItem

Pole wyboruSiatkaElement

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

MetodaZwracany typKrótki opis
clearValidation()CheckboxGridItemUsuwa wszystkie reguły sprawdzania poprawności danych dotyczące tego elementu siatki.
createResponse(responses)ItemResponseTworzy nowy element ItemResponse dla tego elementu siatki z polem wyboru.
duplicate()CheckboxGridItemTworzy kopię tego elementu i dodaje 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 dla elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator produktu.
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 (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem).
getType()ItemTypePobiera typ elementu 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 (czasami 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 (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem).
setValidation(validation)CheckboxGridItemOkreśla sprawdzanie poprawności danych dla tego elementu siatki z polem wyboru.

Szczegółowa dokumentacja

clearValidation()

Usuwa wszystkie reguły sprawdzania poprawności danych dotyczące tego elementu siatki.

Powrót

CheckboxGridItem – 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

createResponse(responses)

Tworzy nowy element ItemResponse 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

NazwaTypOpis
responsesString[][]tablica tablic prawidłowych odpowiedzi dla tego elementu siatki pól wyboru

Powrót

ItemResponse – 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

CheckboxGridItem – duplikat tego elementu CheckboxGridItem, 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

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, 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

getHelpText()

Pobiera tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).

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

getId()

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

getIndex()

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

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, 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

getTitle()

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

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

getType()

Pobiera typ elementu jako ItemType.

Powrót

ItemType – typ 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

isRequired()

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

setColumns(columns)

Ustawia kolumny siatki na podstawie tablicy wartości. Wyjątek, jeśli podany 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 ł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

setHelpText(text)

Ustawia tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Parametry

NazwaTypOpis
textStringnowy tekst pomocy.

Powrót

CheckboxGridItem – ta CheckboxGridItem, 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

setRequired(enabled)

Określa, czy respondent musi odpowiedzieć na pytanie.

Parametry

NazwaTypOpis
enabledBooleanczy respondent musi udzielić odpowiedzi na pytanie.

Powrót

CheckboxGridItem – 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

setRows(rows)

Ustawia wiersze siatki na podstawie tablicy wartości. Wyjątek, jeśli podany 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 ł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

setTitle(title)

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

Parametry

NazwaTypOpis
titleStringnowy tytuł lub tekst nagłówka.

Powrót

CheckboxGridItem – ta CheckboxGridItem, 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

setValidation(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

NazwaTypOpis
validationCheckboxGridValidationwalidację CheckboxGridValidation, która ma być stosowana w przypadku tego elementu.

Powrót

CheckboxGridItem – ta CheckboxGridItem, 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