Class TableCell

TabelaKomórka

Element reprezentujący komórkę tabeli. Element TableCell jest zawsze zawarty w elemencie TableRow i może zawierać elementy ListItem, Paragraph lub Table. Więcej informacji o strukturze dokumentu znajdziesz w przewodniku po rozszerzaniu Dokumentów Google.

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 nową wartość ListItem.
appendParagraph(paragraph)	Paragraph	Dodaje podany parametr Paragraph.
appendParagraph(text)	Paragraph	Tworzy i dodaje nową wartość Paragraph.
appendTable()	Table	Tworzy i dodaje nową wartość Table.
appendTable(cells)	Table	Dodaje nowy element Table zawierający wskazane komórki.
appendTable(table)	Table	Dodaje podany parametr Table.
clear()	TableCell	Czyści zawartość elementu.
copy()	TableCell	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.
getBackgroundColor()	String	Pobiera kolor tła.
getChild(childIndex)	Element	Pobiera element podrzędny o określonym indeksie podrzędnym.
getChildIndex(child)	Integer	Pobiera indeks podrzędnego elementu podrzędnego.
getColSpan()	Integer	Pobiera zakres kolumny, czyli liczbę kolumn komórek tabeli, które obejmuje ta komórka.
getLinkUrl()	String	Pobiera adres URL linku.
getNextSibling()	Element	Pobiera następny element nadrzędny.
getNumChildren()	Integer	Pobiera liczbę dzieci.
getPaddingBottom()	Number	Pobiera wartość dolnej wypełnienia w punktach.
getPaddingLeft()	Number	Pobiera wartość wypełnienia z lewej strony w punktach.
getPaddingRight()	Number	Pobiera wartość dopełnienia z prawej strony w punktach.
getPaddingTop()	Number	Pobiera wartość górnego dopełnienia w punktach.
getParent()	ContainerElement	Pobiera element nadrzędny.
getParentRow()	TableRow	Pobiera TableRow zawierający bieżący TableCell.
getParentTable()	Table	Pobiera Table zawierający bieżący TableCell.
getPreviousSibling()	Element	Pobiera poprzedni element nadrzędny elementu.
getRowSpan()	Integer	Pobiera zakres wierszy, czyli liczbę wierszy komórek tabeli, które obejmuje dana komórka.
getText()	String	Pobiera zawartość elementu jako ciąg tekstowy.
getTextAlignment()	TextAlignment	Pobiera wyrównanie tekstu.
getType()	ElementType	Pobiera wartość atrybutu ElementType elementu.
getVerticalAlignment()	VerticalAlignment	Pobiera VerticalAlignment.
getWidth()	Number	Pobiera szerokość kolumny zawierającej komórkę w punktach.
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 na wskazanym indeksie.
insertParagraph(childIndex, paragraph)	Paragraph	Wstawia podany element Paragraph na wskazanej pozycji.
insertParagraph(childIndex, text)	Paragraph	Tworzy i wstawia nowy element Paragraph na wskazanym indeksie.
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.
isAtDocumentEnd()	Boolean	Określa, czy element znajduje się na końcu Document.
merge()	TableCell	Łączy element z poprzednim elementem tego samego typu.
removeChild(child)	TableCell	Usuwa określony element podrzędny.
removeFromParent()	TableCell	Usuwa element z jego elementu nadrzędnego.
replaceText(searchPattern, replacement)	Element	Za pomocą wyrażeń regularnych zastępuje wszystkie wystąpienia danego wzorca tekstowego podanym ciągiem tekstowym.
setAttributes(attributes)	TableCell	Ustawia atrybuty elementu.
setBackgroundColor(color)	TableCell	Ustawia kolor tła.
setLinkUrl(url)	TableCell	Ustawia adres URL linku.
setPaddingBottom(paddingBottom)	TableCell	Ustawia dopełnienie dolne w punktach.
setPaddingLeft(paddingLeft)	TableCell	Ustawia wypełnienie z lewej strony w punktach.
setPaddingRight(paddingRight)	TableCell	Ustawia prawe wypełnienie w punktach.
setPaddingTop(paddingTop)	TableCell	Ustawia dopełnienie góry w punktach.
setText(text)	TableCell	Ustawia zawartość jako zwykły tekst.
setTextAlignment(textAlignment)	TableCell	Ustawia wyrównanie tekstu.
setVerticalAlignment(alignment)	TableCell	Ustawia wyrównanie w pionie.
setWidth(width)	TableCell	Ustawia szerokość kolumny zawierającej bieżącą komórkę w punktach.

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.

Element InlineImage będzie zawarty w nowym elemencie Paragraph.

Parametry

Nazwa	Typ	Opis
image	BlobSource	dane obrazu;

Powrót

InlineImage – nowy 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.

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.

Parametry

Nazwa	Typ	Opis
listItem	ListItem	element listy do dodania;

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 nową wartość ListItem.

Parametry

Nazwa	Typ	Opis
text	String	zawartość tekstowa;

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

---

appendParagraph(paragraph)

Dodaje podany parametr Paragraph.

Parametry

Nazwa	Typ	Opis
paragraph	Paragraph	akapit do dołą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 nową wartość Paragraph.

Parametry

Nazwa	Typ	Opis
text	String	zawartość tekstowa;

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.

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 nowy element Table zawierający wskazane komórki.

Parametry

Nazwa	Typ	Opis
cells	String[][]	zawartość tekstową 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.

Parametry

Nazwa	Typ	Opis
table	Table	tabeli, 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

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

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

---

getBackgroundColor()

Pobiera kolor tła.

Powrót

String – kolor tła sformatowany w notacji CSS (np. '#ffffff').

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

---

getColSpan()

Pobiera zakres kolumny, czyli liczbę kolumn komórek tabeli, które obejmuje ta komórka. Komórki, które nie zostały scalone, mają zakres kolumny równy 1.

Powrót

Integer – zakres kolumny lub 0 w przypadku komórki, która jest scalona z inną komórką.

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

---

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

---

getPaddingBottom()

Pobiera wartość dolnej wypełnienia w punktach.

Powrót

Number – wypełnienie u dołu 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

---

getPaddingLeft()

Pobiera wartość wypełnienia z lewej strony w punktach.

Powrót

Number – wypełnienie z lewej 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

---

getPaddingRight()

Pobiera wartość dopełnienia z prawej strony w punktach.

Powrót

Number – prawe wypełnienie 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

---

getPaddingTop()

Pobiera wartość górnego dopełnienia w punktach.

Powrót

Number – górne wypełnienie 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

---

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

---

getParentRow()

Pobiera TableRow zawierający bieżący TableCell.

Powrót

TableRow – wiersz tabeli zawierający bieżącą komórkę

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

---

getParentTable()

Pobiera Table zawierający bieżący TableCell.

Powrót

Table – tabela zawierająca bieżącą komórkę

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

---

getRowSpan()

Pobiera zakres wierszy, czyli liczbę wierszy komórek tabeli, które obejmuje dana komórka. Niescalone komórki mają zasięg 1 wiersza.

Powrót

Integer – zakres wiersza lub 0 w przypadku komórki scalonej z inną komórką.

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

---

getVerticalAlignment()

Pobiera VerticalAlignment.

Powrót

VerticalAlignment — wyrównanie w pionie,

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

---

getWidth()

Pobiera szerokość kolumny zawierającej komórkę w punktach.

Powrót

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

---

insertHorizontalRule(childIndex)

Tworzy i wstawia nowy element HorizontalRule na wskazanym indeksie.

Linia pozioma będzie zawarta w nowej 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.

Obraz będzie zawarty w nowym pliku Paragraph.

Parametry

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

Powrót

InlineImage – wstawiony obraz wbudowany

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 wbudowany

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 zostać wstawiony element;
listItem	ListItem	element listy do wstawienia.

Powrót

ListItem – wstawiono 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

---

insertListItem(childIndex, text)

Tworzy i wstawia nowy element ListItem na wskazanym indeksie.

Parametry

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

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

---

insertParagraph(childIndex, paragraph)

Wstawia podany element Paragraph na wskazanej pozycji.

Parametry

Nazwa	Typ	Opis
childIndex	Integer	indeks, w którym ma zostać wstawiony element;
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 na wskazanym indeksie.

Parametry

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

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 zostać wstawiony element;

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 zostać wstawiony element
cells	String[][]	zawartość tekstową 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 zostać wstawiony element;
table	Table	tabelę 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

---

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

---

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

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

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

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

---

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

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

---

setBackgroundColor(color)

Ustawia kolor tła.

Parametry

Nazwa	Typ	Opis
color	String	kolor tła sformatowany w notacji CSS (np. '#ffffff');

Powrót

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

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

---

setPaddingBottom(paddingBottom)

Ustawia dopełnienie dolne w punktach.

Parametry

Nazwa	Typ	Opis
paddingBottom	Number	uzupełnienie u dołu w punktach

Powrót

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

---

setPaddingLeft(paddingLeft)

Ustawia wypełnienie z lewej strony w punktach.

Parametry

Nazwa	Typ	Opis
paddingLeft	Number	wypełnienie z lewej strony w punktach

Powrót

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

---

setPaddingRight(paddingRight)

Ustawia prawe wypełnienie w punktach.

Parametry

Nazwa	Typ	Opis
paddingRight	Number	Prawe wypełnienie w punktach.

Powrót

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

---

setPaddingTop(paddingTop)

Ustawia dopełnienie góry w punktach.

Parametry

Nazwa	Typ	Opis
paddingTop	Number	odstęp górny w punktach

Powrót

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

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

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

---

setVerticalAlignment(alignment)

Ustawia wyrównanie w pionie.

Parametry

Nazwa	Typ	Opis
alignment	VerticalAlignment	wyrównanie w pionie

Powrót

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

---

setWidth(width)

Ustawia szerokość kolumny zawierającej bieżącą komórkę w punktach.

Parametry

Nazwa	Typ	Opis
width	Number	szerokość kolumny w punktach.

Powrót

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