Class CheckboxGridItem

CheckboxGridItem

Element pytania, przedstawiony jako siatka kolumn i wierszy, który umożliwia respondentowi wybranie tej opcji wiele opcji wyboru na wiersz z sekwencji pól wyboru. Elementy można otwierać i tworzyć w Form

// Open a form by ID and add a new checkbox 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()CheckboxGridItemPowoduje usunięcie sprawdzania poprawności danych w tym elemencie siatki.
createResponse(responses)ItemResponseTworzy nowy element ItemResponse dla tego elementu siatki z polem 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 dotyczący elementu (nazywany czasem opisem 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 siatki.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu reprezentowany przez ItemType.
isRequired()BooleanOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setColumns(columns)CheckboxGridItemUstawia kolumny siatki na podstawie tablicy wartości.
setHelpText(text)CheckboxGridItemUstawia tekst pomocy elementu (nazywany czasem opisu tekstem w przypadku elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setRequired(enabled)CheckboxGridItemOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setRows(rows)CheckboxGridItemUstawia wiersze siatki na podstawie tablicy wartości.
setTitle(title)CheckboxGridItemOkreśla tytuł elementu (w przypadku SectionHeaderItem nazywany też tekstem nagłówka).
setValidation(validation)CheckboxGridItemUstawia sprawdzanie poprawności danych dla tego elementu siatki z polem wyboru.

Szczegółowa dokumentacja

clearValidation()

Powoduje usunięcie sprawdzania poprawności danych w tym elemencie siatki.

Powrót

CheckboxGridItem – ten element do tworzenia łańcuchów,

Autoryzacja

Skrypty korzystające 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[][] zawierającą tablice zawierające tyle wartości, ile danych wejściowych w siatce pól wyboru. Element null niewymaganego pytania z siatką pól wyboru oznacza brak odpowiedzi na dany wiersz. Zgłasza wyjątek, jeśli którakolwiek z wartości nie jest zgodna z poprawny wybór.

Parametry

NazwaTypOpis
responsesString[][]tablica tablic z prawidłowymi odpowiedziami dla tego elementu siatki z polem wyboru

Powrót

ItemResponse – odpowiedź dotycząca produktu,

Autoryzacja

Skrypty korzystające 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 dołącza ją na końcu formularza.

Powrót

CheckboxGridItem – duplikat kodu CheckboxGridItem, na potrzeby tworzenia łańcuchów;

Autoryzacja

Skrypty korzystające 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órą respondenci widzą jako etykiety podczas wyświetlania formularza

Autoryzacja

Skrypty korzystające 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 dotyczący elementu (nazywany czasem opisem w przypadku elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Powrót

String – tekst pomocy dotyczący produktu lub opis.

Autoryzacja

Skrypty korzystające 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 elementu.

Powrót

Integer – identyfikator produktu,

Autoryzacja

Skrypty korzystające 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 korzystające 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 siatki.

Powrót

String[] – tablica wartości wierszy, którą ankietowani widzą jako etykiety podczas wyświetlania formularza

Autoryzacja

Skrypty korzystające 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 (w przypadku SectionHeaderItem nazywany tekstem nagłówka).

Powrót

String – tytuł lub tekst nagłówka elementu;

Autoryzacja

Skrypty korzystające 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 reprezentowany przez ItemType.

Powrót

ItemType – typ elementu,

Autoryzacja

Skrypty korzystające 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 użytkownik musi odpowiedzieć na pytanie.

Powrót

Boolean – czy użytkownik musi odpowiedzieć na pytanie.

Autoryzacja

Skrypty korzystające 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. Zgłasza wyjątek, jeśli dane tablica jest pusta.

Parametry

NazwaTypOpis
columnsString[]tablica wartości kolumn, którą respondenci widzą jako etykiety podczas przeglądania formularza

Powrót

CheckboxGridItem – ten element do tworzenia łańcuchów,

Rzuty

Error – jeśli dana tablica ma wartość null lub jest pusta

Autoryzacja

Skrypty korzystające 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 (nazywany czasem opisu tekstem w przypadku elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Parametry

NazwaTypOpis
textStringnowy tekst pomocy

Powrót

CheckboxGridItemCheckboxGridItem, łańcuch

Autoryzacja

Skrypty korzystające 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 użytkownik musi odpowiedzieć na pytanie.

Parametry

NazwaTypOpis
enabledBooleanczy respondent musi odpowiedzieć na pytanie,

Powrót

CheckboxGridItem – bieżący element (do tworzenia łańcuchów),

Autoryzacja

Skrypty korzystające 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. Zgłasza wyjątek, jeśli dana tablica jest puste.

Parametry

NazwaTypOpis
rowsString[]tablica wartości wierszy, którą respondenci widzą jako etykiety podczas przeglądania formularza

Powrót

CheckboxGridItem – ten element do tworzenia łańcuchów,

Rzuty

Error – jeśli dana tablica ma wartość null lub jest pusta

Autoryzacja

Skrypty korzystające 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)

Określa tytuł elementu (w przypadku SectionHeaderItem nazywany też tekstem nagłówka).

Parametry

NazwaTypOpis
titleStringnowy tytuł lub tekst nagłówka;

Powrót

CheckboxGridItemCheckboxGridItem, łańcuch

Autoryzacja

Skrypty korzystające 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)

Ustawia sprawdzanie poprawności danych dla tego elementu siatki z polem wyboru. Wartość null lub weryfikacja bez wartości wszystkich wywołań wymaganych funkcji spowoduje usunięcie wcześniejszej weryfikacji.

Parametry

NazwaTypOpis
validationCheckboxGridValidationpole CheckboxGridValidation, które ma zostać zastosowane do tego elementu.

Powrót

CheckboxGridItemCheckboxGridItem, łańcuch

Autoryzacja

Skrypty korzystające 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