Class CheckboxItem

CheckboxItem

Element pytania, który pozwala respondentowi zaznaczyć co najmniej jedno pole wyboru oraz opcjonalnie „inne” . Elementy można otwierać i tworzyć na koncie Form. Zastosowanie są oceniane automatycznie.

// Open a form by ID and add a new checkbox item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addCheckboxItem();
item.setTitle('What condiments would you like on your hot dog?')
    .setChoices([
          item.createChoice('Ketchup'),
          item.createChoice('Mustard'),
          item.createChoice('Relish')
    ])
    .showOtherOption(true);

Metody

MetodaZwracany typKrótki opis
clearValidation()CheckboxItemPowoduje usunięcie sprawdzania poprawności danych tego elementu pola wyboru.
createChoice(value)ChoiceTworzy nową opcję.
createChoice(value, isCorrect)ChoiceTworzy nową opcję.
createResponse(responses)ItemResponseTworzy nowy element ItemResponse dla tego elementu wyboru.
duplicate()CheckboxItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getChoices()Choice[]Pobiera wszystkie opcje dotyczące elementu.
getFeedbackForCorrect()QuizFeedbackZwraca informację zwrotną, która wyświetla się użytkownikom, gdy udzielili prawidłowej odpowiedzi na pytanie.
getFeedbackForIncorrect()QuizFeedbackZwraca informację zwrotną, która jest wyświetlana użytkownikom, którzy odpowiedzieli nieprawidłowo na pytanie.
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.
getPoints()IntegerZwraca wartość punktową elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu reprezentowany przez ItemType.
hasOtherOption()BooleanOkreśla, czy element ma atrybut „inne” .
isRequired()BooleanOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setChoiceValues(values)CheckboxItemUstawia opcje elementu na podstawie tablicy ciągów znaków.
setChoices(choices)CheckboxItemUstawia tablicę opcji elementu.
setFeedbackForCorrect(feedback)CheckboxItemUstawia informację, że odpowiedzi będą wyświetlane użytkownikom, gdy odpowiedzą prawidłowo na pytanie.
setFeedbackForIncorrect(feedback)CheckboxItemOkreśla, że odpowiedź na pytanie jest wyświetlana użytkownikom, którzy odpowiedzą nieprawidłowo na pytanie.
setHelpText(text)CheckboxItemUstawia tekst pomocy elementu (nazywany czasem opisu tekstem w przypadku elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setPoints(points)CheckboxItemOkreśla liczbę punktów wartą oceniany element.
setRequired(enabled)CheckboxItemOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setTitle(title)CheckboxItemOkreśla tytuł elementu (w przypadku SectionHeaderItem nazywany też tekstem nagłówka).
setValidation(validation)CheckboxItemOkreśla sprawdzanie poprawności danych dla tego elementu pola wyboru.
showOtherOption(enabled)CheckboxItemOkreśla, czy element ma atrybut „inne” .

Szczegółowa dokumentacja

clearValidation()

Powoduje usunięcie sprawdzania poprawności danych tego elementu pola wyboru.

Powrót

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

createChoice(value)

Tworzy nową opcję.

Parametry

NazwaTypOpis
valueStringwartość wyboru, którą respondenci widzą jako etykietę podczas wyświetlania formularza

Powrót

Choice – nowa opcja

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

createChoice(value, isCorrect)

Tworzy nową opcję.

Parametry

NazwaTypOpis
valueStringwartość wyboru, którą respondenci widzą jako etykietę podczas wyświetlania formularza
isCorrectBooleanczy wybrana odpowiedź jest poprawna

Powrót

Choice – nowa opcja

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 wyboru. Argument responses to Tablica String[] zawierająca wartości, które należy sprawdzić. Zgłasza wyjątek, jeśli istnieje Wartość nie pasuje do prawidłowej opcji wyboru dla tego produktu, chyba że atrybut showOtherOption(enabled) ma wartość true.

Parametry

NazwaTypOpis
responsesString[]tablica poprawnych odpowiedzi na ten element jednokrotnego 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

CheckboxItem – duplikat kodu CheckboxItem, 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

getChoices()

Pobiera wszystkie opcje dotyczące elementu.

Powrót

Choice[] – tablica opcji

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

getFeedbackForCorrect()

Zwraca informację zwrotną, która wyświetla się użytkownikom, gdy udzielili prawidłowej odpowiedzi na pytanie.

Powrót

QuizFeedback – ewentualne opinie.

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

getFeedbackForIncorrect()

Zwraca informację zwrotną, która jest wyświetlana użytkownikom, którzy odpowiedzieli nieprawidłowo na pytanie.

Powrót

QuizFeedback – ewentualne opinie.

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

getPoints()

Zwraca wartość punktową elementu podlegającego ocenie.

Powrót

Integer – liczba punktów warte dane 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

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

hasOtherOption()

Określa, czy element ma atrybut „inne” .

Powrót

Booleantrue, jeśli element ma wartość „inny” opcja; false, jeśli nie

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

setChoiceValues(values)

Ustawia opcje elementu na podstawie tablicy ciągów znaków. Zgłasza wyjątek, jeśli dana tablica jest puste.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

Parametry

NazwaTypOpis
valuesString[]tablicę wartości wyboru, którą respondenci widzą jako etykiety podczas przeglądania formularza

Powrót

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

setChoices(choices)

Ustawia tablicę opcji elementu. Zgłasza wyjątek, jeśli dana tablica jest pusta lub zawiera element null.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?')
item.setChoices([
    item.createChoice('Cats'),
    item.createChoice('Dogs')
]);

Parametry

NazwaTypOpis
choicesChoice[]szeroki wybór

Powrót

CheckboxItemCheckboxItem, łańcuch

Rzuty

Error – jeśli dana tablica jest null, pusta lub zawiera element null,

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

setFeedbackForCorrect(feedback)

Ustawia informację, że odpowiedzi będą wyświetlane użytkownikom, gdy odpowiedzą prawidłowo na pytanie.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
// Set "Dogs" as the correct answer to this question.
item.setChoices([
  item.createChoice('Dogs', true),
  item.createChoice('Cats', false)]);
// Add feedback which will be shown for correct responses; ie "Dogs".
item.setFeedbackForCorrect(
    FormApp.createFeedback().setDisplayText("Dogs rule, cats drool.").build());

Parametry

NazwaTypOpis
feedbackQuizFeedbacknowych opinii. Wartość null usuwa informację zwrotną.

Powrót

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

setFeedbackForIncorrect(feedback)

Określa, że odpowiedź na pytanie jest wyświetlana użytkownikom, którzy odpowiedzą nieprawidłowo na pytanie.

Parametry

NazwaTypOpis
feedbackQuizFeedbacknowa opinia

Powrót

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

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

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

setPoints(points)

Określa liczbę punktów wartą oceniany element. Wartość domyślna nowych elementów to 0.

Parametry

NazwaTypOpis
pointsIntegerliczba punktów warta przedmiot pytania

Powrót

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

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

setTitle(title)

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

Parametry

NazwaTypOpis
titleStringnowy tytuł lub tekst nagłówka;

Powrót

CheckboxItemCheckboxItem, ł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)

Określa sprawdzanie poprawności danych dla tego elementu pola wyboru. Wartość null lub weryfikacja bez wartości wymaga wywołania funkcji, co spowoduje usunięcie wcześniejszej weryfikacji.

Parametry

NazwaTypOpis
validationCheckboxValidationpole CheckboxValidation, które ma zostać zastosowane do tego elementu.

Powrót

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

showOtherOption(enabled)

Określa, czy element ma atrybut „inne” . Ustawienie domyślne dla nowego modelu CheckboxItem lub MultipleChoiceItemfalse.

Parametry

NazwaTypOpis
enabledBooleantrue, jeśli element ma wartość „inne” opcja; false, jeśli nie

Powrót

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