Ta strona została przetłumaczona przez Cloud Translation API.

Interface Item

Ogólny element formularza zawierający właściwości wspólne dla wszystkich elementów, takie jak tytuł i tekst pomocy. Elementy można otwierać i tworzyć na koncie Form.

Aby przeprowadzać operacje na właściwościach konkretnych typów, użyj polecenia getType() do sprawdzenia elementu ItemType elementu, a następnie rzutuj element na odpowiednią klasę za pomocą metody takiej jak asCheckboxItem().

// Create a new form and add a text item.
var form = FormApp.create('Form Name');
form.addTextItem();

// Access the text item as a generic item.
var items = form.getItems();
var item = items[0];

// Cast the generic item to the text-item class.
if (item.getType() == 'TEXT') {
  var textItem = item.asTextItem();
  textItem.setRequired(false);
}

Wdrażanie klas

Nazwa	Krótki opis

Metody

Metoda	Zwracany typ	Krótki opis
`asCheckboxGridItem()`	`CheckboxGridItem`	Zwraca element jako element siatki pól wyboru.
`asCheckboxItem()`	`CheckboxItem`	Wyświetla element jako pole wyboru.
`asDateItem()`	`DateItem`	Zwraca element jako element daty.
`asDateTimeItem()`	`DateTimeItem`	Zwraca element jako element daty i godziny.
`asDurationItem()`	`DurationItem`	Zwraca element jako element czasu trwania.
`asGridItem()`	`GridItem`	Zwraca element jako element siatki.
`asImageItem()`	`ImageItem`	Zwraca element jako obraz.
`asListItem()`	`ListItem`	Zwraca element jako element listy.
`asMultipleChoiceItem()`	`MultipleChoiceItem`	Zwraca produkt jako element jednokrotnego wyboru.
`asPageBreakItem()`	`PageBreakItem`	Zwraca element jako element podziału strony.
`asParagraphTextItem()`	`ParagraphTextItem`	Zwraca element jako element z tekstem akapitu.
`asScaleItem()`	`ScaleItem`	Zwraca element jako element wagi.
`asSectionHeaderItem()`	`SectionHeaderItem`	Zwraca element jako element w nagłówku sekcji.
`asTextItem()`	`TextItem`	Zwraca element jako element tekstowy.
`asTimeItem()`	`TimeItem`	Zwraca element jako element czasu.
`asVideoItem()`	`VideoItem`	Zwraca element jako element wideo.
`duplicate()`	`Item`	Tworzy kopię tego elementu i dołącza ją na końcu formularza.
`getHelpText()`	`String`	Pobiera tekst pomocy dotyczący elementu (nazywany czasem opisem w przypadku elementów układu takich jak `ImageItems`, `PageBreakItems` i `SectionHeaderItems`).
`getId()`	`Integer`	Pobiera unikalny identyfikator elementu.
`getIndex()`	`Integer`	Pobiera indeks elementu spośród wszystkich elementów w formularzu.
`getTitle()`	`String`	Pobiera tytuł elementu (w przypadku `SectionHeaderItem` nazywany tekstem nagłówka).
`getType()`	`ItemType`	Pobiera typ elementu reprezentowany przez `ItemType`.
`setHelpText(text)`	`Item`	Ustawia tekst pomocy elementu (nazywany czasem opisu tekstem w przypadku elementów układu takich jak `ImageItems`, `PageBreakItems` i `SectionHeaderItems`).
`setTitle(title)`	`Item`	Określa tytuł elementu (w przypadku `SectionHeaderItem` nazywany też tekstem nagłówka).

Szczegółowa dokumentacja

`asCheckboxGridItem()`

Zwraca element jako element siatki pól wyboru. Zgłasza wyjątek skryptu, jeśli ItemType nie był wcześniej CHECKBOX_GRID.

Powrót

CheckboxGridItem – element siatki z polami wyboru;

Rzuty

Error – jeśli element nie jest elementem siatki z polami wyboru;

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

`asCheckboxItem()`

Wyświetla element jako pole wyboru. Zgłasza wyjątek skryptu, jeśli ItemType nie był wcześniej CHECKBOX.

Powrót

CheckboxItem – element pola wyboru,

Rzuty

Error – jeśli element nie jest polem wyboru;

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

`asDateItem()`

Zwraca element jako element daty. Zgłasza wyjątek skryptu, jeśli ItemType nie był wcześniej DATE.

Powrót

DateItem – element daty,

Rzuty

Error – jeśli element nie jest elementem daty,

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

`asDateTimeItem()`

Zwraca element jako element daty i godziny. Zgłasza wyjątek skryptu, jeśli ItemType nie był wcześniej DATETIME.

Powrót

DateTimeItem – element daty i godziny.

Rzuty

Error – jeśli element nie jest elementem daty i godziny;

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

`asDurationItem()`

Zwraca element jako element czasu trwania. Zgłasza wyjątek skryptu, jeśli ItemType nie był wcześniej DURATION.

Powrót

DurationItem – element czasu trwania;

Rzuty

Error – jeśli element nie ma ustalonego czasu trwania.

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

`asGridItem()`

Zwraca element jako element siatki. Zgłasza wyjątek skryptu, jeśli ItemType nie był wcześniej GRID.

Powrót

GridItem – element siatki

Rzuty

Error – jeśli element nie jest elementem siatki

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

`asImageItem()`

Zwraca element jako obraz. Zgłasza wyjątek skryptu, jeśli ItemType nie był wcześniej IMAGE.

Powrót

ImageItem – element obrazu

Rzuty

Error – jeśli produkt nie jest obrazem;

`asListItem()`

Zwraca element jako element listy. Zgłasza wyjątek skryptu, jeśli ItemType nie był wcześniej LIST.

Powrót

ListItem – element listy,

Rzuty

Error – jeśli element nie jest elementem listy,

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

`asMultipleChoiceItem()`

Zwraca produkt jako element jednokrotnego wyboru. Zgłasza wyjątek skryptu, jeśli ItemType nie był wcześniej MULTIPLE_CHOICE.

Powrót

MultipleChoiceItem – element jednokrotnego wyboru

Rzuty

Error – jeśli produkt nie jest produktem jednokrotnego wyboru;

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

`asPageBreakItem()`

Zwraca element jako element podziału strony. Zgłasza wyjątek skryptu, jeśli ItemType nie był wcześniej PAGE_BREAK.

Powrót

PageBreakItem – element podziału strony

Rzuty

Error – jeśli element nie jest elementem podziału strony.

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

`asParagraphTextItem()`

Zwraca element jako element z tekstem akapitu. Zgłasza wyjątek skryptu, jeśli ItemType nie był wcześniej PARAGRAPH_TEXT.

Powrót

ParagraphTextItem – element tekstowy akapitu.

Rzuty

Error – jeśli element nie jest elementem tekstowym akapitu.

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

`asScaleItem()`

Zwraca element jako element wagi. Zgłasza wyjątek skryptu, jeśli ItemType nie był wcześniej SCALE.

Powrót

ScaleItem – element wagi

Rzuty

Error – jeśli produkt nie jest elementem wagi.

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

`asSectionHeaderItem()`

Zwraca element jako element w nagłówku sekcji. Zgłasza wyjątek skryptu, jeśli ItemType nie był wcześniej SECTION_HEADER.

Powrót

SectionHeaderItem – element w nagłówku sekcji;

Rzuty

Error – jeśli element nie jest elementem nagłówka sekcji;

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

`asTextItem()`

Zwraca element jako element tekstowy. Zgłasza wyjątek skryptu, jeśli ItemType nie był wcześniej TEXT.

Powrót

TextItem – element tekstowy,

Rzuty

Error – jeśli element nie jest elementem tekstowym.

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

`asTimeItem()`

Zwraca element jako element czasu. Zgłasza wyjątek skryptu, jeśli ItemType nie był wcześniej TIME.

Powrót

TimeItem – element czasu.

Rzuty

Error – jeśli element nie jest elementem czasu.

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

`asVideoItem()`

Zwraca element jako element wideo. Zgłasza wyjątek skryptu, jeśli ItemType nie był wcześniej VIDEO.

Powrót

VideoItem – element wideo.

Rzuty

Error – jeśli element nie jest elementem wideo.

`duplicate()`

Tworzy kopię tego elementu i dołącza ją na końcu formularza.

Powrót

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

`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

`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

`setHelpText(text)`

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

Parametry

Nazwa	Typ	Opis
`text`	`String`	nowy tekst pomocy

Powrót

Item – Item, ł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

`setTitle(title)`

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

Parametry

Nazwa	Typ	Opis
`title`	`String`	nowy tytuł lub tekst nagłówka;

Powrót

Item – Item, ł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