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

Class Body

Treść karty w dokumencie Dokumentów Google. Element Body może zawierać elementy ListItem, Paragraph, Table i TableOfContents. Więcej informacji o strukturze dokumentu znajdziesz w przewodniku po rozszerzaniu Dokumentów Google.

Element Body zawiera zwykle całą zawartość karty, z wyjątkiem elementów HeaderSection, FooterSection i elementów FootnoteSection.

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

// Append a paragraph and a page break to the tab's body section directly.
body.appendParagraph('A paragraph.');
body.appendPageBreak();

Metody

Metoda	Zwracany typ	Krótki opis
`appendHorizontalRule()`	`HorizontalRule`	Tworzy i dodaje nową wartość `HorizontalRule`.
`appendImage(image)`	`InlineImage`	Tworzy i dodaje nowy element `InlineImage` z określonego bloba obrazu.
`appendImage(image)`	`InlineImage`	Dodaje podany parametr `InlineImage`.
`appendListItem(listItem)`	`ListItem`	Dodaje podany parametr `ListItem`.
`appendListItem(text)`	`ListItem`	Tworzy i dodaje nowy element `ListItem` zawierający określony tekst.
`appendPageBreak()`	`PageBreak`	Tworzy i dodaje nową wartość `PageBreak`.
`appendPageBreak(pageBreak)`	`PageBreak`	Dodaje podany parametr `PageBreak`.
`appendParagraph(paragraph)`	`Paragraph`	Dodaje podany parametr `Paragraph`.
`appendParagraph(text)`	`Paragraph`	Tworzy i dodaje nowy element `Paragraph` zawierający określony tekst.
`appendTable()`	`Table`	Tworzy i dodaje nową wartość `Table`.
`appendTable(cells)`	`Table`	Dodaje nową wartość `Table` zawierającą element `TableCell` dla każdej określonej wartości ciągu znaków.
`appendTable(table)`	`Table`	Dodaje podany parametr `Table`.
`clear()`	`Body`	Czyści zawartość elementu.
`copy()`	`Body`	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.
`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.
`getHeadingAttributes(paragraphHeading)`	`Object`	Pobiera zestaw atrybutów dla podanego obiektu `ParagraphHeading`.
`getImages()`	`InlineImage[]`	Pobiera wszystkie `InlineImages` zawarte w sekcji.
`getListItems()`	`ListItem[]`	Pobiera wszystkie `ListItems` zawarte w sekcji.
`getMarginBottom()`	`Number`	Pobiera dolny margines w punktach.
`getMarginLeft()`	`Number`	Pobiera lewy margines w punktach.
`getMarginRight()`	`Number`	Pobiera prawy margines.
`getMarginTop()`	`Number`	Pobiera górne marginesy.
`getNumChildren()`	`Integer`	Pobiera liczbę dzieci.
`getPageHeight()`	`Number`	Pobiera wysokość strony w punktach.
`getPageWidth()`	`Number`	Pobiera szerokość strony w punktach.
`getParagraphs()`	`Paragraph[]`	Pobiera wszystkie `Paragraphs` zawarte w sekcji (w tym `ListItems`).
`getParent()`	`ContainerElement`	Pobiera element nadrzędny.
`getTables()`	`Table[]`	Pobiera wszystkie `Tables` zawarte w sekcji.
`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 nowy element `HorizontalRule` na wskazanym indeksie.
`insertImage(childIndex, image)`	`InlineImage`	Tworzy i wstawia `InlineImage` z określonego bloba obrazu na określonym indeksie.
`insertImage(childIndex, image)`	`InlineImage`	Wstawia podany element `InlineImage` na wskazanej pozycji.
`insertListItem(childIndex, listItem)`	`ListItem`	Wstawia podany element `ListItem` na wskazanej pozycji.
`insertListItem(childIndex, text)`	`ListItem`	Tworzy i wstawia nowy element `ListItem` w wybranym miejscu, zawierający podany tekst.
`insertPageBreak(childIndex)`	`PageBreak`	Tworzy i wstawia nowy element `PageBreak` na wskazanym indeksie.
`insertPageBreak(childIndex, pageBreak)`	`PageBreak`	Wstawia podany element `PageBreak` na wskazanej pozycji.
`insertParagraph(childIndex, paragraph)`	`Paragraph`	Wstawia podany element `Paragraph` na wskazanej pozycji.
`insertParagraph(childIndex, text)`	`Paragraph`	Tworzy i wstawia nowy element `Paragraph` w wybranym miejscu, zawierający podany tekst.
`insertTable(childIndex)`	`Table`	Tworzy i wstawia nowy element `Table` na wskazanym indeksie.
`insertTable(childIndex, cells)`	`Table`	Tworzy i wstawia nowy element `Table` zawierający wskazane komórki w wybranym indeksie.
`insertTable(childIndex, table)`	`Table`	Wstawia podany element `Table` na wskazanej pozycji.
`removeChild(child)`	`Body`	Usuwa określony element podrzędny.
`replaceText(searchPattern, replacement)`	`Element`	Za pomocą wyrażeń regularnych zastępuje wszystkie wystąpienia danego wzorca tekstowego podanym ciągiem tekstowym.
`setAttributes(attributes)`	`Body`	Ustawia atrybuty elementu.
`setHeadingAttributes(paragraphHeading, attributes)`	`Body`	Ustawia atrybuty dla podanego obiektu `ParagraphHeading`.
`setMarginBottom(marginBottom)`	`Body`	Ustawia dolny margines w punktach.
`setMarginLeft(marginLeft)`	`Body`	Ustawia lewy margines w punktach.
`setMarginRight(marginRight)`	`Body`	Ustawia prawy margines w punktach.
`setMarginTop(marginTop)`	`Body`	Ustawia górny margines.
`setPageHeight(pageHeight)`	`Body`	Ustawia wysokość strony w punktach.
`setPageWidth(pageWidth)`	`Body`	Ustawia szerokość strony w punktach.
`setText(text)`	`Body`	Ustawia zawartość jako zwykły tekst.
`setTextAlignment(textAlignment)`	`Body`	Ustawia wyrównanie tekstu.

Wycofane metody

Metoda	Zwracany typ	Krótki opis
`getFootnotes()`	`Footnote[]`	Pobiera wszystkie `Footnotes` zawarte w sekcji.
`getLinkUrl()`	`String`	Pobiera adres URL linku.
`getNextSibling()`	`Element`	Pobiera następny element nadrzędny.
`getPreviousSibling()`	`Element`	Pobiera poprzedni element nadrzędny elementu.
`isAtDocumentEnd()`	`Boolean`	Określa, czy element znajduje się na końcu `Document`.
`setLinkUrl(url)`	`Body`	Ustawia adres URL linku.

Szczegółowa dokumentacja

`appendHorizontalRule()`

Tworzy i dodaje nową wartość HorizontalRule.

Element HorizontalRule będzie zawarty w nowym elemencie Paragraph.

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

`appendImage(image)`

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

Obraz będzie zawarty w nowym pliku Paragraph.

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

`appendImage(image)`

Dodaje podany parametr InlineImage.

Element InlineImage będzie zawarty w nowym elemencie Paragraph.

Użyj tej wersji appendImage, dołączając kopię istniejącej wersji 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

`appendListItem(listItem)`

Dodaje podany parametr ListItem.

Użyj tej wersji appendListItem, dołączając kopię istniejącej wersji ListItem.

Parametry

Nazwa	Typ	Opis
`listItem`	`ListItem`	Element listy do dołączenia.

Powrót

ListItem – dołączony element 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

`appendListItem(text)`

Tworzy i dodaje nowy element ListItem zawierający określony tekst.

Kolejne elementy listy są dodawane jako część tej samej listy.

Parametry

Nazwa	Typ	Opis
`text`	`String`	Treść tekstowa elementu listy.

Powrót

ListItem – nowy element 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

`appendPageBreak()`

Tworzy i dodaje nową wartość PageBreak.

Element PageBreak będzie zawarty w nowym elemencie Paragraph.

Powrót

PageBreak – nowy podział 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.

Element PageBreak będzie zawarty w nowym elemencie Paragraph.

Użyj tej wersji appendPageBreak, dołączając kopię istniejącej wersji PageBreak.

Parametry

Nazwa	Typ	Opis
`pageBreak`	`PageBreak`	Podział strony do dołączenia.

Powrót

PageBreak – dołączony podział 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

`appendParagraph(paragraph)`

Dodaje podany parametr Paragraph.

Użyj tej wersji appendParagraph, dołączając kopię istniejącej wersji Paragraph.

Parametry

Nazwa	Typ	Opis
`paragraph`	`Paragraph`	Akapit do załączenia.

Powrót

Paragraph – załączony akapit.

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

`appendParagraph(text)`

Tworzy i dodaje nowy element Paragraph zawierający określony tekst.

Parametry

Nazwa	Typ	Opis
`text`	`String`	Treść tekstu akapitu.

Powrót

Paragraph – nowy akapit.

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

`appendTable()`

Tworzy i dodaje nową wartość Table.

Ta metoda spowoduje też dodanie pustego akapitu po tabeli, ponieważ dokumenty Dokumentów Google nie mogą kończyć się tabelą.

Powrót

Table – nowa tabela.

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

`appendTable(cells)`

Dodaje nową wartość Table zawierającą element TableCell dla każdej określonej wartości ciągu znaków.

Ta metoda spowoduje też dodanie pustego akapitu po tabeli, ponieważ dokumenty Dokumentów Google nie mogą kończyć się tabelą.

Parametry

Nazwa	Typ	Opis
`cells`	`String[][]`	Treść tekstowa komórek tabeli, którą chcesz dodać do nowej tabeli.

Powrót

Table – dołączona tabela.

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

`appendTable(table)`

Dodaje podany parametr Table.

Użyj tej wersji appendTable, dołączając kopię istniejącej wersji Table. Ta metoda spowoduje też dodanie pustego akapitu po tabeli, ponieważ dokumenty Dokumentów Google nie mogą kończyć się tabelą.

Parametry

Nazwa	Typ	Opis
`table`	`Table`	Tabela, do której chcesz dołączyć dane.

Powrót

Table – dołączona tabela.

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

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

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

`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

`getHeadingAttributes(paragraphHeading)`

Pobiera zestaw atrybutów dla podanego obiektu ParagraphHeading.

Parametry

Nazwa	Typ	Opis
`paragraphHeading`	`ParagraphHeading`	Nagłówek, którego atrybuty mają zostać pobrane.

Powrót

Object – mapowanie atrybutów i ich bieżących wartości.

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

`getImages()`

Pobiera wszystkie InlineImages zawarte w sekcji.

Powrót

InlineImage[] – obrazy sekcji.

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

`getListItems()`

Pobiera wszystkie ListItems zawarte w sekcji.

Powrót

ListItem[] – elementy listy sekcji.

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

`getMarginBottom()`

Pobiera dolny margines w punktach.

Powrót

Number – dolny margines 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

`getMarginLeft()`

Pobiera lewy margines w punktach.

Powrót

Number – lewy margines 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

`getMarginRight()`

Pobiera prawy margines.

Powrót

Number – prawy margines 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

`getMarginTop()`

Pobiera górne marginesy.

Powrót

Number – górny margines 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

`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

`getPageHeight()`

Pobiera wysokość strony w punktach.

Powrót

Number – wysokość strony 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

`getPageWidth()`

Pobiera szerokość strony w punktach.

Powrót

Number – szerokość strony 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

`getParagraphs()`

Pobiera wszystkie Paragraphs zawarte w sekcji (w tym ListItems).

Powrót

Paragraph[] – akapity sekcji.

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

`getTables()`

Pobiera wszystkie Tables zawarte w sekcji.

Powrót

Table[] – tabele sekcji.

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 nowy element HorizontalRule na wskazanym indeksie.

Element HorizontalRule będzie zawarty w nowym elemencie Paragraph.

Parametry

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

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

`insertImage(childIndex, image)`

Tworzy i wstawia InlineImage z określonego bloba obrazu na określonym indeksie.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	Indeks, w którym ma zostać wstawiony element.
`image`	`BlobSource`	Dane obrazu.

Powrót

InlineImage – wstawiony 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

`insertImage(childIndex, image)`

Wstawia podany element InlineImage na wskazanej pozycji.

Obraz będzie zawarty w nowym pliku Paragraph.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	Indeks, w którym ma zostać wstawiony element.
`image`	`InlineImage`	Obraz do wstawienia.

Powrót

InlineImage – wstawiony 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

`insertListItem(childIndex, listItem)`

Wstawia podany element ListItem na wskazanej pozycji.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	Indeks, w którym ma nastąpić wstawienie.
`listItem`	`ListItem`	Element listy do wstawienia.

Powrót

ListItem – wstawiony element 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

`insertListItem(childIndex, text)`

Tworzy i wstawia nowy element ListItem w wybranym miejscu, zawierający podany tekst.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	Indeks, w którym ma nastąpić wstawienie.
`text`	`String`	Treść tekstowa elementu listy.

Powrót

ListItem – nowy element 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

`insertPageBreak(childIndex)`

Tworzy i wstawia nowy element PageBreak na wskazanym indeksie.

Element PageBreak będzie zawarty w nowym elemencie Paragraph.

Parametry

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

Powrót

PageBreak – nowy podział 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.

Element PageBreak będzie zawarty w nowym elemencie Paragraph.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	Indeks, w którym ma zostać wstawiony element.
`pageBreak`	`PageBreak`	Podział strony do wstawienia.

Powrót

PageBreak – wstawiony podział 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

`insertParagraph(childIndex, paragraph)`

Wstawia podany element Paragraph na wskazanej pozycji.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	Indeks, w którym ma nastąpić wstawienie.
`paragraph`	`Paragraph`	Akapit do wstawienia.

Powrót

Paragraph – wstawiony akapit.

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

`insertParagraph(childIndex, text)`

Tworzy i wstawia nowy element Paragraph w wybranym miejscu, zawierający podany tekst.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	Indeks, w którym ma nastąpić wstawienie.
`text`	`String`	Treść tekstu akapitu.

Powrót

Paragraph – nowy akapit.

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

`insertTable(childIndex)`

Tworzy i wstawia nowy element Table na wskazanym indeksie.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	Indeks, w którym ma nastąpić wstawienie.

Powrót

Table – nowa tabela.

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

`insertTable(childIndex, cells)`

Tworzy i wstawia nowy element Table zawierający wskazane komórki w wybranym indeksie.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	Indeks, w którym ma nastąpić wstawienie.
`cells`	`String[][]`	Treść tekstowa komórek tabeli, którą chcesz dodać do nowej tabeli.

Powrót

Table – nowa tabela.

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

`insertTable(childIndex, table)`

Wstawia podany element Table na wskazanej pozycji.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	Indeks, w którym ma nastąpić wstawienie.
`table`	`Table`	Tabela do wstawienia.

Powrót

Table – wstawiona tabela.

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

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

`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

`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

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

`setHeadingAttributes(paragraphHeading, attributes)`

Ustawia atrybuty dla podanego obiektu ParagraphHeading.

Parametry

Nazwa	Typ	Opis
`paragraphHeading`	`ParagraphHeading`	Nagłówek, którego atrybuty mają zostać ustawione.
`attributes`	`Object`	Mapowanie atrybutów i ich wartości.

Powrót

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

`setMarginBottom(marginBottom)`

Ustawia dolny margines w punktach.

Parametry

Nazwa	Typ	Opis
`marginBottom`	`Number`	Dolny margines w punktach.

Powrót

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

`setMarginLeft(marginLeft)`

Ustawia lewy margines w punktach.

Parametry

Nazwa	Typ	Opis
`marginLeft`	`Number`	Lewy margines w punktach.

Powrót

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

`setMarginRight(marginRight)`

Ustawia prawy margines w punktach.

Parametry

Nazwa	Typ	Opis
`marginRight`	`Number`	Prawy margines.

Powrót

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

`setMarginTop(marginTop)`

Ustawia górny margines.

Parametry

Nazwa	Typ	Opis
`marginTop`	`Number`	Górny margines (w punktach).

Powrót

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

`setPageHeight(pageHeight)`

Ustawia wysokość strony w punktach.

Parametry

Nazwa	Typ	Opis
`pageHeight`	`Number`	Wysokość strony w punktach.

Powrót

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

`setPageWidth(pageWidth)`

Ustawia szerokość strony w punktach.

Parametry

Nazwa	Typ	Opis
`pageWidth`	`Number`	Szerokość strony w punktach.

Powrót

Body – 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ść jako zwykły tekst.

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

Parametry

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

Powrót

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

`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

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

Wycofane metody

`getFootnotes()`

Wycofany. Ten element nie może zawierać elementu Footnote.

Pobiera wszystkie Footnotes zawarte w sekcji.

Powrót

Footnote[] – przypisy do sekcji.

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()`

Wycofany. Zamiast linkować całą sekcję, linkuj element w tej sekcji.

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

`getNextSibling()`

Wycofany. Ten element nie ma żadnych elementów nadrzędnych.

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

`getPreviousSibling()`

Wycofany. Ten element nie ma żadnych elementów nadrzędnych.

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

`isAtDocumentEnd()`

Wycofany. Ta metoda nie jest niezawodna w przypadku HeaderSection.

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

`setLinkUrl(url)`

Wycofany. Zamiast linkować całą sekcję, linkuj element w tej sekcji.

Ustawia adres URL linku.

Parametry

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

Powrót

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