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

Class ListItem

Element reprezentujący element listy. ListItem to Paragraph powiązany z identyfikatorem listy. Element ListItem może zawierać elementy Equation, Footnote, HorizontalRule, InlineDrawing, InlineImage, PageBreak i Text. Więcej informacji o strukturze dokumentu znajdziesz w przewodniku po rozszerzaniu Dokumentów Google.

ListItems nie może zawierać znaków nowego wiersza. Znaki nowego wiersza ("\n") są konwertowane na znaki podziału wiersza ("\r").

ListItems o tym samym identyfikatorze listy należą do tej samej listy i są odpowiednio ponumerowane. Elementy ListItems danej listy nie muszą znajdować się obok siebie na karcie ani mieć tego samego elementu nadrzędnego. 2 elementy należące do tej samej listy mogą znajdować się w dowolnym miejscu na karcie, zachowując ciągłą numerację, jak w tym przykładzie:

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Append a new list item to the body.
const item1 = body.appendListItem('Item 1');

// Log the new list item's list ID.
Logger.log(item1.getListId());

// Append a table after the list item.
body.appendTable([['Cell 1', 'Cell 2']]);

// Append a second list item with the same list ID. The two items are treated as
// the same list, despite not being consecutive.
const item2 = body.appendListItem('Item 2');
item2.setListId(item1);

Metody

Metoda	Zwracany typ	Krótki opis
`addPositionedImage(image)`	`PositionedImage`	Tworzy i wstawia nowy element `PositionedImage` z określonego bloba obrazu.
`appendHorizontalRule()`	`HorizontalRule`	Tworzy i dodaje nową wartość `HorizontalRule`.
`appendInlineImage(image)`	`InlineImage`	Tworzy i dodaje nowy element `InlineImage` z określonego bloba obrazu.
`appendInlineImage(image)`	`InlineImage`	Dodaje podany parametr `InlineImage`.
`appendPageBreak()`	`PageBreak`	Tworzy i dodaje nową wartość `PageBreak`.
`appendPageBreak(pageBreak)`	`PageBreak`	Dodaje podany parametr `PageBreak`.
`appendText(text)`	`Text`	Tworzy i dodaje nowy element `Text` z określonymi treściami.
`appendText(text)`	`Text`	Dodaje podany element `Text`.
`clear()`	`ListItem`	Czyści zawartość elementu.
`copy()`	`ListItem`	Zwraca odłączoną, głęboką kopię bieżącego elementu.
`editAsText()`	`Text`	Pobiera wersję `Text` bieżącego elementu do edycji.
`findElement(elementType)`	`RangeElement`	Przeszukuje zawartość elementu pod kątem potomka określonego typu.
`findElement(elementType, from)`	`RangeElement`	Przeszukuje zawartość elementu pod kątem potomka określonego typu, zaczynając od określonego elementu `RangeElement`.
`findText(searchPattern)`	`RangeElement`	Przeszukuje zawartość elementu pod kątem określonego wzorca tekstowego za pomocą wyrażeń regularnych.
`findText(searchPattern, from)`	`RangeElement`	Przeszukuje zawartość elementu pod kątem określonego wzoru tekstowego, zaczynając od danego wyniku wyszukiwania.
`getAlignment()`	`HorizontalAlignment`	Pobiera `HorizontalAlignment`.
`getAttributes()`	`Object`	Pobiera atrybuty elementu.
`getChild(childIndex)`	`Element`	Pobiera element podrzędny o określonym indeksie podrzędnym.
`getChildIndex(child)`	`Integer`	Pobiera indeks podrzędnego elementu podrzędnego.
`getGlyphType()`	`GlyphType`	Pobiera wartość atrybutu `GlyphType` elementu listy.
`getHeading()`	`ParagraphHeading`	Pobiera `ParagraphHeading`.
`getIndentEnd()`	`Number`	Pobiera wcięcie końcowe w punktach.
`getIndentFirstLine()`	`Number`	Pobiera wcięcie pierwszego wiersza w punktach.
`getIndentStart()`	`Number`	Pobiera wcięcie początkowe.
`getLineSpacing()`	`Number`	Pobiera odstęp między wierszami w punktach.
`getLinkUrl()`	`String`	Pobiera adres URL linku.
`getListId()`	`String`	Pobiera identyfikator listy.
`getNestingLevel()`	`Integer`	Pobiera poziom zagnieżdżenia elementu listy.
`getNextSibling()`	`Element`	Pobiera następny element nadrzędny.
`getNumChildren()`	`Integer`	Pobiera liczbę dzieci.
`getParent()`	`ContainerElement`	Pobiera element nadrzędny.
`getPositionedImage(id)`	`PositionedImage`	Pobiera `PositionedImage` według identyfikatora obrazu.
`getPositionedImages()`	`PositionedImage[]`	Pobiera wszystkie obiekty `PositionedImage` zakotwiczone w akapicie.
`getPreviousSibling()`	`Element`	Pobiera poprzedni element nadrzędny elementu.
`getSpacingAfter()`	`Number`	Pobiera odstęp po elemencie w punktach.
`getSpacingBefore()`	`Number`	Pobiera odstęp przed elementem w punktach.
`getText()`	`String`	Pobiera zawartość elementu jako ciąg tekstowy.
`getTextAlignment()`	`TextAlignment`	Pobiera wyrównanie tekstu.
`getType()`	`ElementType`	Pobiera wartość atrybutu `ElementType` elementu.
`insertHorizontalRule(childIndex)`	`HorizontalRule`	Tworzy i wstawia element `HorizontalRule` na wskazanym indeksie.
`insertInlineImage(childIndex, image)`	`InlineImage`	Tworzy i wstawia nowy element `InlineImage` z określonego bloba obrazu na wskazanym indeksie.
`insertInlineImage(childIndex, image)`	`InlineImage`	Wstawia podany element `InlineImage` na wskazanej pozycji.
`insertPageBreak(childIndex)`	`PageBreak`	Tworzy i wstawia nowy element `PageBreak` na wskazanym indeksie.
`insertPageBreak(childIndex, pageBreak)`	`PageBreak`	Wstawia podany element `PageBreak` na wskazanej pozycji.
`insertText(childIndex, text)`	`Text`	Tworzy i wstawia nowy element tekstowy na określonym indeksie.
`insertText(childIndex, text)`	`Text`	Wstawia podany element `Text` w wybranym indeksie z wybranym tekstem.
`isAtDocumentEnd()`	`Boolean`	Określa, czy element znajduje się na końcu `Document`.
`isLeftToRight()`	`Boolean`	Pobiera ustawienie tekstu od lewej do prawej.
`merge()`	`ListItem`	Łączy element z poprzednim elementem tego samego typu.
`removeChild(child)`	`ListItem`	Usuwa określony element podrzędny.
`removeFromParent()`	`ListItem`	Usuwa element z jego elementu nadrzędnego.
`removePositionedImage(id)`	`Boolean`	Usuwa `PositionedImage` według identyfikatora obrazu.
`replaceText(searchPattern, replacement)`	`Element`	Za pomocą wyrażeń regularnych zastępuje wszystkie wystąpienia danego wzorca tekstowego podanym ciągiem tekstowym.
`setAlignment(alignment)`	`ListItem`	Ustawia wartość `HorizontalAlignment`.
`setAttributes(attributes)`	`ListItem`	Ustawia atrybuty elementu.
`setGlyphType(glyphType)`	`ListItem`	Ustawia `GlyphType` elementu listy.
`setHeading(heading)`	`ListItem`	Ustawia wartość `ParagraphHeading`.
`setIndentEnd(indentEnd)`	`ListItem`	Ustawia wcięcie końcowe w punktach.
`setIndentFirstLine(indentFirstLine)`	`ListItem`	Ustawia wcięcie pierwszego wiersza w punktach.
`setIndentStart(indentStart)`	`ListItem`	Ustawia wcięcie początkowe w punktach.
`setLeftToRight(leftToRight)`	`ListItem`	Ustawia kierunek od lewej do prawej.
`setLineSpacing(multiplier)`	`ListItem`	Ustawia odstęp między wierszami jako liczbę wierszy, które mają być użyte do wypełnienia.
`setLinkUrl(url)`	`ListItem`	Ustawia adres URL linku.
`setListId(listItem)`	`ListItem`	Ustawia identyfikator listy.
`setNestingLevel(nestingLevel)`	`ListItem`	Ustawia poziom zagnieżdżenia elementu listy.
`setSpacingAfter(spacingAfter)`	`ListItem`	Ustawia odstęp po elemencie w punktach.
`setSpacingBefore(spacingBefore)`	`ListItem`	Ustawia odstęp przed elementem w punktach.
`setText(text)`	`void`	Ustawia zawartość pozycji listy jako tekst.
`setTextAlignment(textAlignment)`	`ListItem`	Ustawia wyrównanie tekstu.

Szczegółowa dokumentacja

`addPositionedImage(image)`

Tworzy i wstawia nowy element PositionedImage z określonego bloba obrazu.

Parametry

Nazwa	Typ	Opis
`image`	`BlobSource`	dane obrazu;

Powrót

PositionedImage – nowo umieszczony obraz

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`appendHorizontalRule()`

Tworzy i dodaje nową wartość HorizontalRule.

Powrót

HorizontalRule – nowa linia pozioma

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`appendInlineImage(image)`

Tworzy i dodaje nowy element InlineImage z określonego bloba obrazu.

Parametry

Nazwa	Typ	Opis
`image`	`BlobSource`	dane obrazu;

Powrót

InlineImage – dołączony obraz

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`appendInlineImage(image)`

Dodaje podany parametr InlineImage.

Parametry

Nazwa	Typ	Opis
`image`	`InlineImage`	dane obrazu;

Powrót

InlineImage – dołączony obraz

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`appendPageBreak()`

Tworzy i dodaje nową wartość PageBreak.

Uwaga: PageBreaks może nie być zawarty w TableCells. Jeśli bieżący element znajduje się w komórce tabeli, zostanie rzucony wyjątek.

Powrót

PageBreak – nowy element podziału strony

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`appendPageBreak(pageBreak)`

Dodaje podany parametr PageBreak.

Uwaga: PageBreaks może nie być zawarty w TableCells. Jeśli bieżący element znajduje się w komórce tabeli, zostanie rzucony wyjątek.

Parametry

Nazwa	Typ	Opis
`pageBreak`	`PageBreak`	podział strony, który chcesz dołączyć

Powrót

PageBreak – dołączony element podziału strony,

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`appendText(text)`

Tworzy i dodaje nowy element Text z określonymi treściami.

Parametry

Nazwa	Typ	Opis
`text`	`String`	zawartość tekstowa;

Powrót

Text – nowy element tekstowy

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`appendText(text)`

Dodaje podany element Text.

Parametry

Nazwa	Typ	Opis
`text`	`Text`	element tekstowy, który chcesz dodać;

Powrót

Text – dołączony element tekstowy

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`clear()`

Czyści zawartość elementu.

Powrót

ListItem – bieżący element.

`copy()`

Zwraca odłączoną, głęboką kopię bieżącego elementu.

Skopiowane zostaną też wszystkie elementy podrzędne obecne w danym elemencie. Nowy element nie ma rodzica.

Powrót

ListItem – nowa kopia.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`editAsText()`

Pobiera wersję Text bieżącego elementu do edycji.

Aby manipulować zawartością elementów jako tekstem sformatowanym, użyj editAsText. Tryb editAsText ignoruje elementy inne niż tekstowe (takie jak InlineImage i HorizontalRule).

Elementy podrzędne całkowicie zawarte w usuniętym zakresie tekstu są usuwane z elementu.

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Insert two paragraphs separated by a paragraph containing an
// horizontal rule.
body.insertParagraph(0, 'An editAsText sample.');
body.insertHorizontalRule(0);
body.insertParagraph(0, 'An example.');

// Delete " sample.\n\n An" removing the horizontal rule in the process.
body.editAsText().deleteText(14, 25);

Powrót

Text – tekstowa wersja bieżącego elementu

`findElement(elementType)`

Przeszukuje zawartość elementu pod kątem potomka określonego typu.

Parametry

Nazwa	Typ	Opis
`elementType`	`ElementType`	Typ elementu do wyszukania.

Powrót

RangeElement – wynik wyszukiwania wskazujący pozycję elementu wyszukiwania.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`findElement(elementType, from)`

Przeszukuje zawartość elementu pod kątem potomka określonego typu, zaczynając od określonego elementu RangeElement.

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Define the search parameters.

let searchResult = null;

// Search until the paragraph is found.
while (
    (searchResult = body.findElement(
         DocumentApp.ElementType.PARAGRAPH,
         searchResult,
         ))) {
  const par = searchResult.getElement().asParagraph();
  if (par.getHeading() === DocumentApp.ParagraphHeading.HEADING1) {
    // Found one, update and stop.
    par.setText('This is the first header.');
    break;
  }
}

Parametry

Nazwa	Typ	Opis
`elementType`	`ElementType`	Typ elementu do wyszukania.
`from`	`RangeElement`	Wynik wyszukiwania, z którego chcesz wyszukiwać.

Powrót

RangeElement – wynik wyszukiwania wskazujący następną pozycję elementu wyszukiwania.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`findText(searchPattern)`

Przeszukuje zawartość elementu pod kątem określonego wzorca tekstowego za pomocą wyrażeń regularnych.

Niektóre funkcje wyrażeń regularnych JavaScript nie są w pełni obsługiwane, np. grupy uchwytywania i modyfikatory trybu.

Podany wzorzec wyrażenia regularnego jest niezależnie dopasowywany do każdego bloku tekstu zawartego w bieżącym elemencie.

Parametry

Nazwa	Typ	Opis
`searchPattern`	`String`	wzór do wyszukania.

Powrót

RangeElement – wynik wyszukiwania wskazujący pozycję tekstu wyszukiwania lub null, jeśli nie ma dopasowania

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`findText(searchPattern, from)`

Przeszukuje zawartość elementu pod kątem określonego wzoru tekstowego, zaczynając od danego wyniku wyszukiwania.

Niektóre funkcje wyrażeń regularnych JavaScript nie są w pełni obsługiwane, np. grupy uchwytywania i modyfikatory trybu.

Podany wzorzec wyrażenia regularnego jest niezależnie dopasowywany do każdego bloku tekstu zawartego w bieżącym elemencie.

Parametry

Nazwa	Typ	Opis
`searchPattern`	`String`	wzór do wyszukania.
`from`	`RangeElement`	wynik wyszukiwania, z którego chcesz wyszukiwać

Powrót

RangeElement – wynik wyszukiwania wskazujący następną pozycję tekstu wyszukiwania lub null, jeśli nie ma dopasowania

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getAlignment()`

Pobiera HorizontalAlignment.

Powrót

HorizontalAlignment – wyrównanie

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getAttributes()`

Pobiera atrybuty elementu.

Wynikiem jest obiekt zawierający właściwość dla każdego prawidłowego atrybutu elementu, przy czym każda nazwa właściwości odpowiada elementowi w wyliczeniu DocumentApp.Attribute.

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Append a styled paragraph.
const par = body.appendParagraph('A bold, italicized paragraph.');
par.setBold(true);
par.setItalic(true);

// Retrieve the paragraph's attributes.
const atts = par.getAttributes();

// Log the paragraph attributes.
for (const att in atts) {
  Logger.log(`${att}:${atts[att]}`);
}

Powrót

Object – atrybuty elementu.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getChild(childIndex)`

Pobiera element podrzędny o określonym indeksie podrzędnym.

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Obtain the first element in the tab.
const firstChild = body.getChild(0);

// If it's a paragraph, set its contents.
if (firstChild.getType() === DocumentApp.ElementType.PARAGRAPH) {
  firstChild.asParagraph().setText('This is the first paragraph.');
}

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	Indeks elementu podrzędnego do pobrania.

Powrót

Element – element podrzędny o określonym indeksie.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getChildIndex(child)`

Pobiera indeks podrzędnego elementu podrzędnego.

Parametry

Nazwa	Typ	Opis
`child`	`Element`	Element podrzędny, którego indeks ma zostać pobrany.

Powrót

Integer – indeks podrzędny.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getGlyphType()`

Pobiera wartość atrybutu GlyphType elementu listy.

Powrót

GlyphType – typ glifu

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getHeading()`

Pobiera ParagraphHeading.

Powrót

ParagraphHeading – nagłówek

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getIndentEnd()`

Pobiera wcięcie końcowe w punktach.

Powrót

Number – wcięcie na końcu w punktach

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getIndentFirstLine()`

Pobiera wcięcie pierwszego wiersza w punktach.

Powrót

Number – wcięcie pierwszego wiersza w punktach

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getIndentStart()`

Pobiera wcięcie początkowe.

Powrót

Number – wcięcie na początku

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getLineSpacing()`

Pobiera odstęp między wierszami w punktach.

Powrót

Number – odstępy między wierszami w punktach.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getLinkUrl()`

Pobiera adres URL linku.

Powrót

String – adres URL linku lub null, jeśli element zawiera wiele wartości tego atrybutu

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getListId()`

Pobiera identyfikator listy.

Powrót

String – identyfikator listy

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getNestingLevel()`

Pobiera poziom zagnieżdżenia elementu listy.

Domyślnie pozycje listy mają poziom zagnieżdżenia 0. Poziom zagnieżdżania określa symbol używany przez element listy.

Powrót

Integer – poziom zagnieżdżenia,

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getNextSibling()`

Pobiera następny element nadrzędny.

Następny element równego rzędu ma tego samego rodzica i następuje po bieżącym elemencie.

Powrót

Element – następny element równorzędny.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getNumChildren()`

Pobiera liczbę dzieci.

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Log the number of elements in the tab.
Logger.log(`There are ${body.getNumChildren()} elements in the tab's body.`);

Powrót

Integer – liczba dzieci.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getParent()`

Pobiera element nadrzędny.

Element nadrzędny zawiera bieżący element.

Powrót

ContainerElement – element nadrzędny.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getPositionedImage(id)`

Pobiera PositionedImage według identyfikatora obrazu.

Parametry

Nazwa	Typ	Opis
`id`	`String`	identyfikator obrazu.

Powrót

PositionedImage – umieszczony obraz

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getPositionedImages()`

Pobiera wszystkie obiekty PositionedImage zakotwiczone w akapicie.

Powrót

PositionedImage[] – lista umieszczonych obrazów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getPreviousSibling()`

Pobiera poprzedni element nadrzędny elementu.

Poprzedni element ma tego samego rodzica i poprzedza bieżący element.

Powrót

Element – poprzedni równorzędny element.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getSpacingAfter()`

Pobiera odstęp po elemencie w punktach.

Powrót

Number – odstęp po elemencie w punktach

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getSpacingBefore()`

Pobiera odstęp przed elementem w punktach.

Powrót

Number – odstęp przed elementem w punktach

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getText()`

Pobiera zawartość elementu jako ciąg tekstowy.

Powrót

String – zawartość elementu jako ciąg tekstowy

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getTextAlignment()`

Pobiera wyrównanie tekstu. Dostępne typy wyrównania to DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT i DocumentApp.TextAlignment.SUPERSCRIPT.

Powrót

TextAlignment – typ wyrównania tekstu lub null, jeśli tekst zawiera wiele typów wyrównania lub jeśli wyrównanie tekstu nigdy nie zostało ustawione

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getType()`

Pobiera wartość atrybutu ElementType elementu.

Aby określić dokładny typ danego elementu, użyj właściwości getType().

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Obtain the first element in the active tab's body.

const firstChild = body.getChild(0);

// Use getType() to determine the element's type.
if (firstChild.getType() === DocumentApp.ElementType.PARAGRAPH) {
  Logger.log('The first element is a paragraph.');
} else {
  Logger.log('The first element is not a paragraph.');
}

Powrót

ElementType – 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/documents.currentonly
https://www.googleapis.com/auth/documents

`insertHorizontalRule(childIndex)`

Tworzy i wstawia element HorizontalRule na wskazanym indeksie.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	indeks, w którym ma zostać wstawiony element;

Powrót

HorizontalRule – nowy element linii poziomej

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertInlineImage(childIndex, image)`

Tworzy i wstawia nowy element InlineImage z określonego bloba obrazu na wskazanym indeksie.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	indeks, w którym ma zostać wstawiony element;
`image`	`BlobSource`	dane obrazu;

Powrót

InlineImage – wstawiony obraz w tekście

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertInlineImage(childIndex, image)`

Wstawia podany element InlineImage na wskazanej pozycji.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	indeks, w którym ma zostać wstawiony element;
`image`	`InlineImage`	dane obrazu;

Powrót

InlineImage – wstawiony obraz w tekście

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertPageBreak(childIndex)`

Tworzy i wstawia nowy element PageBreak na wskazanym indeksie.

Uwaga: PageBreaks może nie być zawarty w TableCells. Jeśli bieżący element znajduje się w komórce tabeli, zostanie rzucony wyjątek.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	indeks, w którym ma zostać wstawiony element;

Powrót

PageBreak – nowy element podziału strony

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertPageBreak(childIndex, pageBreak)`

Wstawia podany element PageBreak na wskazanej pozycji.

Uwaga: PageBreaks może nie być zawarty w TableCells. Jeśli bieżący element znajduje się w komórce tabeli, zostanie rzucony wyjątek.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	indeks, w którym ma zostać wstawiony element;
`pageBreak`	`PageBreak`	podział strony, który chcesz wstawić

Powrót

PageBreak – wstawiony element podziału strony

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertText(childIndex, text)`

Tworzy i wstawia nowy element tekstowy na określonym indeksie.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	indeks, w którym ma zostać wstawiony element;
`text`	`String`	zawartość tekstowa;

Powrót

Text – nowy element tekstowy

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertText(childIndex, text)`

Wstawia podany element Text w wybranym indeksie z wybranym tekstem.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	indeks, w którym ma zostać wstawiony element;
`text`	`Text`	element tekstowy do wstawienia.

Powrót

Text – wstawiony element tekstowy

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`isAtDocumentEnd()`

Określa, czy element znajduje się na końcu Document.

Powrót

Boolean – określa, czy element znajduje się na końcu karty.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`isLeftToRight()`

Pobiera ustawienie tekstu od lewej do prawej.

Powrót

Boolean – ustawienie od lewej do prawej

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`merge()`

Łączy element z poprzednim elementem tego samego typu.

Można scalać tylko elementy tego samego ElementType. Wszystkie elementy podrzędne zawarte w bieżącym elemencie zostaną przeniesione do poprzedniego elementu nadrzędnego.

Bieżący element zostanie usunięty z dokumentu.

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Example 1: Merge paragraphs
// Append two paragraphs to the document's active tab.
const par1 = body.appendParagraph('Paragraph 1.');
const par2 = body.appendParagraph('Paragraph 2.');
// Merge the newly added paragraphs into a single paragraph.
par2.merge();

// Example 2: Merge table cells
// Create a two-dimensional array containing the table's cell contents.
const cells = [
  ['Row 1, Cell 1', 'Row 1, Cell 2'],
  ['Row 2, Cell 1', 'Row 2, Cell 2'],
];
// Build a table from the array.
const table = body.appendTable(cells);
// Get the first row in the table.
const row = table.getRow(0);
// Get the two cells in this row.
const cell1 = row.getCell(0);
const cell2 = row.getCell(1);
// Merge the current cell into its preceding sibling element.
const merged = cell2.merge();

Powrót

ListItem – scalony element.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`removeChild(child)`

Usuwa określony element podrzędny.

Parametry

Nazwa	Typ	Opis
`child`	`Element`	element podrzędny do usunięcia.

Powrót

ListItem – bieżący element.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`removeFromParent()`

Usuwa element z jego elementu nadrzędnego.

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Remove all images in the active tab's body.
const imgs = body.getImages();
for (let i = 0; i < imgs.length; i++) {
  imgs[i].removeFromParent();
}

Powrót

ListItem – usunięty element.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`removePositionedImage(id)`

Usuwa PositionedImage według identyfikatora obrazu.

Parametry

Nazwa	Typ	Opis
`id`	`String`

Powrót

Boolean – czy wskazany obraz został usunięty

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`replaceText(searchPattern, replacement)`

Za pomocą wyrażeń regularnych zastępuje wszystkie wystąpienia danego wzorca tekstowego podanym ciągiem tekstowym.

Wzór wyszukiwania jest przekazywany jako ciąg znaków, a nie obiekt wyrażenia regularnego JavaScriptu. W tym celu musisz uciec się do użycia ukośnika wstecznego w wzorze.

Ta metoda korzysta z biblioteki wyrażeń regularnych RE2 firmy Google, która ogranicza obsługiwaną składnię.

Podany wzorzec wyrażenia regularnego jest niezależnie dopasowywany do każdego bloku tekstu zawartego w bieżącym elemencie.

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Clear the text surrounding "Apps Script", with or without text.
body.replaceText('^.*Apps ?Script.*$', 'Apps Script');

Parametry

Nazwa	Typ	Opis
`searchPattern`	`String`	wzór wyrażenia regularnego do wyszukania;
`replacement`	`String`	tekst, który ma być użyty jako tekst zastępczy;

Powrót

Element – bieżący element.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setAlignment(alignment)`

Ustawia wartość HorizontalAlignment.

Parametry

Nazwa	Typ	Opis
`alignment`	`HorizontalAlignment`	wyrównanie w poziomie;

Powrót

ListItem – bieżący element.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setAttributes(attributes)`

Ustawia atrybuty elementu.

Parametr specified attributes musi być obiektem, w którym każda nazwa właściwości jest elementem zbioru wyliczenia DocumentApp.Attribute, a każda wartość właściwości jest nową wartością do zastosowania.

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Define a custom paragraph style.
const style = {};
style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] =
    DocumentApp.HorizontalAlignment.RIGHT;
style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri';
style[DocumentApp.Attribute.FONT_SIZE] = 18;
style[DocumentApp.Attribute.BOLD] = true;

// Append a plain paragraph.
const par = body.appendParagraph('A paragraph with custom style.');

// Apply the custom style.
par.setAttributes(style);

Parametry

Nazwa	Typ	Opis
`attributes`	`Object`	atrybuty elementu,

Powrót

ListItem – bieżący element.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setGlyphType(glyphType)`

Ustawia GlyphType elementu listy.

Parametry

Nazwa	Typ	Opis
`glyphType`	`GlyphType`	typ glifu,

Powrót

ListItem – bieżący element.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setHeading(heading)`

Ustawia wartość ParagraphHeading.

Parametry

Nazwa	Typ	Opis
`heading`	`ParagraphHeading`	nagłówek

Powrót

ListItem – bieżący element.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setIndentEnd(indentEnd)`

Ustawia wcięcie końcowe w punktach.

Parametry

Nazwa	Typ	Opis
`indentEnd`	`Number`	wcięcie na końcu w punktach

Powrót

ListItem – bieżący element.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setIndentFirstLine(indentFirstLine)`

Ustawia wcięcie pierwszego wiersza w punktach.

Parametry

Nazwa	Typ	Opis
`indentFirstLine`	`Number`	wcięcie pierwszego wiersza w punktach

Powrót

ListItem – bieżący element.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setIndentStart(indentStart)`

Ustawia wcięcie początkowe w punktach.

Parametry

Nazwa	Typ	Opis
`indentStart`	`Number`	wcięcie na początku w punktach

Powrót

ListItem – bieżący element.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setLeftToRight(leftToRight)`

Ustawia kierunek od lewej do prawej.

Parametry

Nazwa	Typ	Opis
`leftToRight`	`Boolean`	ustawienie od lewej do prawej.

Powrót

ListItem – bieżący element.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setLineSpacing(multiplier)`

Ustawia odstęp między wierszami jako liczbę wierszy, które mają być użyte do wypełnienia.

Parametry

Nazwa	Typ	Opis
`multiplier`	`Number`	liczba wierszy,

Powrót

ListItem – bieżący element.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setLinkUrl(url)`

Ustawia adres URL linku.

Parametry

Nazwa	Typ	Opis
`url`	`String`	adres URL linku,

Powrót

ListItem – bieżący element.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setListId(listItem)`

Ustawia identyfikator listy.

Identyfikator listy ma tę samą wartość w przypadku określonego parametru ListItem. Te 2 elementy ListItems będą traktowane jako elementy tej samej listy.

Parametry

Nazwa	Typ	Opis
`listItem`	`ListItem`	element listy, którego identyfikator listy ma być użyty

Powrót

ListItem – bieżący element.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setNestingLevel(nestingLevel)`

Ustawia poziom zagnieżdżenia elementu listy.

Domyślnie pozycje listy mają poziom zagnieżdżenia 0. Poziom zagnieżdżania określa symbol używany przez element listy.

Parametry

Nazwa	Typ	Opis
`nestingLevel`	`Integer`	poziom zagnieżdżenia

Powrót

ListItem – bieżący element.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setSpacingAfter(spacingAfter)`

Ustawia odstęp po elemencie w punktach.

Parametry

Nazwa	Typ	Opis
`spacingAfter`	`Number`	odstęp po elemencie w punktach.

Powrót

ListItem – bieżący element.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setSpacingBefore(spacingBefore)`

Ustawia odstęp przed elementem w punktach.

Parametry

Nazwa	Typ	Opis
`spacingBefore`	`Number`	odstęp przed elementem w punktach.

Powrót

ListItem – bieżący element.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setText(text)`

Ustawia zawartość pozycji listy jako tekst.

Uwaga: istniejące treści zostaną usunięte.

Parametry

Nazwa	Typ	Opis
`text`	`String`	nowe treści tekstowe.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setTextAlignment(textAlignment)`

Ustawia wyrównanie tekstu. Dostępne typy wyrównania to DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT i DocumentApp.TextAlignment.SUPERSCRIPT.

// Make the entire first paragraph in the active tab be superscript.
const documentTab =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
const text = documentTab.getBody().getParagraphs()[0].editAsText();
text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);

Parametry

Nazwa	Typ	Opis
`textAlignment`	`TextAlignment`	typ wyrównania tekstu, który ma być zastosowany.

Powrót

ListItem – bieżący element.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents