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

Class TableCell

Element reprezentujący komórkę tabeli. Element TableCell zawsze znajduje się wewnątrz elementu 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 dołącza nowy element `HorizontalRule`.
`appendImage(image)`	`InlineImage`	Tworzy i dołącza nowy element `InlineImage` z określonego obiektu blob obrazu.
`appendImage(image)`	`InlineImage`	Dołącza podany element `InlineImage`.
`appendListItem(listItem)`	`ListItem`	Dołącza podany element `ListItem`.
`appendListItem(text)`	`ListItem`	Tworzy i dołącza nowy element `ListItem`.
`appendParagraph(paragraph)`	`Paragraph`	Dołącza podany element `Paragraph`.
`appendParagraph(text)`	`Paragraph`	Tworzy i dołącza nowy element `Paragraph`.
`appendTable()`	`Table`	Tworzy i dołącza nowy element `Table`.
`appendTable(cells)`	`Table`	Dołącza nowy `Table` zawierający określone komórki.
`appendTable(table)`	`Table`	Dołącza podany element `Table`.
`clear()`	`TableCell`	Usuwa 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\|null`	Przeszukuje zawartość elementu pod kątem elementu podrzędnego określonego typu.
`findElement(elementType, from)`	`RangeElement\|null`	Przeszukuje zawartość elementu pod kątem elementu podrzędnego określonego typu, zaczynając od określonego elementu `RangeElement`.
`findText(searchPattern)`	`RangeElement\|null`	Przeszukuje zawartość elementu pod kątem określonego wzorca tekstu za pomocą wyrażeń regularnych.
`findText(searchPattern, from)`	`RangeElement\|null`	Przeszukuje zawartość elementu pod kątem określonego wzorca tekstu, zaczynając od danego wyniku wyszukiwania.
`getAttributes()`	`Object`	Pobiera atrybuty elementu.
`getBackgroundColor()`	`String\|null`	Pobiera kolor tła.
`getChild(childIndex)`	`Element`	Pobiera element podrzędny o określonym indeksie.
`getChildIndex(child)`	`Integer`	Pobiera indeks elementu podrzędnego dla określonego elementu podrzędnego.
`getColSpan()`	`Integer`	Pobiera zakres kolumn, czyli liczbę kolumn komórek tabeli, które obejmuje ta komórka.
`getLinkUrl()`	`String\|null`	Pobiera adres URL linku.
`getNextSibling()`	`Element\|null`	Pobiera następny element równorzędny.
`getNumChildren()`	`Integer`	Pobiera liczbę dzieci.
`getPaddingBottom()`	`Number\|null`	Pobiera dopełnienie u dołu w punktach.
`getPaddingLeft()`	`Number\|null`	Pobiera dopełnienie z lewej strony w punktach.
`getPaddingRight()`	`Number\|null`	Pobiera dopełnienie z prawej strony w punktach.
`getPaddingTop()`	`Number\|null`	Pobiera dopełnienie u góry w punktach.
`getParent()`	`ContainerElement\|null`	Pobiera element nadrzędny elementu.
`getParentRow()`	`TableRow\|null`	Pobiera `TableRow` zawierający bieżący `TableCell`.
`getParentTable()`	`Table\|null`	Pobiera `Table` zawierający bieżący `TableCell`.
`getPreviousSibling()`	`Element\|null`	Pobiera poprzedni element sąsiedni elementu.
`getRowSpan()`	`Integer`	Pobiera zakres wierszy, czyli liczbę wierszy komórek tabeli, które obejmuje ta komórka.
`getText()`	`String`	Pobiera zawartość elementu jako ciąg tekstowy.
`getTextAlignment()`	`TextAlignment\|null`	Pobiera wyrównanie tekstu.
`getType()`	`ElementType`	Pobiera `ElementType` elementu.
`getVerticalAlignment()`	`VerticalAlignment\|null`	Pobiera `VerticalAlignment`.
`getWidth()`	`Number\|null`	Pobiera szerokość kolumny zawierającej komórkę w punktach.
`insertHorizontalRule(childIndex)`	`HorizontalRule`	Tworzy i wstawia nowy element `HorizontalRule` w określonym indeksie.
`insertImage(childIndex, image)`	`InlineImage`	Tworzy i wstawia `InlineImage` z określonego obiektu blob obrazu w określonym indeksie.
`insertImage(childIndex, image)`	`InlineImage`	Wstawia podany element `InlineImage` w określonym indeksie.
`insertListItem(childIndex, listItem)`	`ListItem`	Wstawia podany element `ListItem` w określonym indeksie.
`insertListItem(childIndex, text)`	`ListItem`	Tworzy i wstawia nowy element `ListItem` w określonym indeksie.
`insertParagraph(childIndex, paragraph)`	`Paragraph`	Wstawia podany element `Paragraph` w określonym indeksie.
`insertParagraph(childIndex, text)`	`Paragraph`	Tworzy i wstawia nowy element `Paragraph` w określonym indeksie.
`insertTable(childIndex)`	`Table`	Tworzy i wstawia nowy element `Table` w określonym indeksie.
`insertTable(childIndex, cells)`	`Table`	Tworzy i wstawia nowy element `Table` zawierający określone komórki we wskazanym indeksie.
`insertTable(childIndex, table)`	`Table`	Wstawia podany element `Table` w określonym indeksie.
`isAtDocumentEnd()`	`Boolean`	Określa, czy element znajduje się na końcu `Document`.
`merge()`	`TableCell\|null`	Łączy element z poprzednim elementem tego samego typu.
`removeChild(child)`	`TableCell`	Usuwa określony element podrzędny.
`removeFromParent()`	`TableCell\|null`	Usuwa element z elementu nadrzędnego.
`replaceText(searchPattern, replacement)`	`Element`	Zamienia wszystkie wystąpienia danego wzorca tekstu na dany ciąg zastępczy, korzystając z wyrażeń regularnych.
`setAttributes(attributes)`	`TableCell`	Ustawia atrybuty elementu.
`setBackgroundColor(color)`	`TableCell`	Ustawia kolor tła.
`setLinkUrl(url)`	`TableCell`	Ustawia adres URL linku.
`setPaddingBottom(paddingBottom)`	`TableCell`	Ustawia dolne dopełnienie w punktach.
`setPaddingLeft(paddingLeft)`	`TableCell`	Ustawia dopełnienie z lewej strony w punktach.
`setPaddingRight(paddingRight)`	`TableCell`	Ustawia dopełnienie z prawej strony w punktach.
`setPaddingTop(paddingTop)`	`TableCell`	Ustawia górne dopełnienie 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 dołącza nowy element HorizontalRule.

Element HorizontalRule będzie znajdować się w nowym elemencie Paragraph.

Powrót

HorizontalRule – nowa linia pozioma;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`appendImage(image)`

Tworzy i dołącza nowy element InlineImage z określonego obiektu blob obrazu.

Element InlineImage będzie znajdować się w nowym elemencie Paragraph.

Parametry

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

Powrót

InlineImage – nowy obraz,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`appendImage(image)`

Dołącza podany element InlineImage.

Element InlineImage będzie znajdować się w nowym elemencie Paragraph.

Parametry

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

Powrót

InlineImage – dołączony obraz;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`appendListItem(listItem)`

Dołącza podany element ListItem.

Parametry

Nazwa	Typ	Opis
`listItem`	`ListItem`	element listy do dołączenia

Powrót

ListItem – dodany element listy.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`appendListItem(text)`

Tworzy i dołącza nowy element ListItem.

Parametry

Nazwa	Typ	Opis
`text`	`String`	zawartość tekstową,

Powrót

ListItem – nowy element listy.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`appendParagraph(paragraph)`

Dołącza podany element Paragraph.

Parametry

Nazwa	Typ	Opis
`paragraph`	`Paragraph`	akapit do dołączenia,

Powrót

Paragraph – dołączony akapit.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`appendParagraph(text)`

Tworzy i dołącza nowy element Paragraph.

Parametry

Nazwa	Typ	Opis
`text`	`String`	zawartość tekstową,

Powrót

Paragraph – nowy akapit

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`appendTable()`

Tworzy i dołącza nowy element Table.

Powrót

Table – nowa tabela.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`appendTable(cells)`

Dołącza nowy Table zawierający określone komórki.

Parametry

Nazwa	Typ	Opis
`cells`	`String[][]`	treść tekstową komórek tabeli, która ma zostać dodana do nowej tabeli;

Powrót

Table – dołączona tabela.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`appendTable(table)`

Dołącza podany element Table.

Parametry

Nazwa	Typ	Opis
`table`	`Table`	tabela do dołączenia,

Powrót

Table – dołączona tabela.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`clear()`

Usuwa zawartość elementu.

Powrót

TableCell – bieżący element.

`copy()`

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

Kopiowane są też wszystkie elementy podrzędne znajdujące się w elemencie. Nowy element nie ma elementu nadrzędnego.

Powrót

TableCell – nowy tekst.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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.

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

Elementy podrzędne w pełni zawarte w zakresie usuniętego 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 elementu podrzędnego określonego typu.

Parametry

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 elementu podrzędnego 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|null – wynik wyszukiwania wskazujący następną pozycję elementu wyszukiwania.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 tekstu za pomocą wyrażeń regularnych.

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

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

Parametry

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 wzorca tekstu, zaczynając od danego wyniku wyszukiwania.

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

Podany wzorzec wyrażenia regularnego jest dopasowywany niezależnie 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|null – wynik wyszukiwania wskazujący następną pozycję tekstu wyszukiwania lub wartość null, jeśli nie ma dopasowania.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 nazwa każdej 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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|null – kolor tła w formacie notacji CSS (np. '#ffffff').

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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.

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 w określonym indeksie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getChildIndex(child)`

Pobiera indeks elementu podrzędnego dla określonego elementu podrzędnego.

Parametry

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

Powrót

Integer – indeks podrzędny.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getColSpan()`

Pobiera zakres kolumn, czyli liczbę kolumn komórek tabeli, które obejmuje ta komórka. Niepołączone komórki mają zakres kolumn równy 1.

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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|null – adres URL linku lub wartość null, jeśli element zawiera wiele wartości tego atrybutu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getNextSibling()`

Pobiera następny element równorzędny.

Następny element równorzędny ma tego samego rodzica i występuje po bieżącym elemencie.

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getPaddingBottom()`

Pobiera dopełnienie u dołu w punktach.

Powrót

Number|null – dopełnienie u dołu w punktach;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getPaddingLeft()`

Pobiera dopełnienie z lewej strony w punktach.

Powrót

Number|null – dopełnienie z lewej strony w punktach;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getPaddingRight()`

Pobiera dopełnienie z prawej strony w punktach.

Powrót

Number|null – dopełnienie z prawej strony w punktach;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getPaddingTop()`

Pobiera dopełnienie u góry w punktach.

Powrót

Number|null – dopełnienie u góry w punktach;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getParent()`

Pobiera element nadrzędny elementu.

Element nadrzędny zawiera bieżący element.

Powrót

ContainerElement|null – element nadrzędny.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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|null – wiersz tabeli zawierający bieżącą komórkę;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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|null – tabela zawierająca bieżącą komórkę;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getPreviousSibling()`

Pobiera poprzedni element sąsiedni elementu.

Poprzedni element równorzędny ma tego samego rodzica i występuje przed bieżącym elementem.

Powrót

Element|null – poprzedni element równorzędny.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 ta komórka. Niescalone komórki mają zakres wierszy równy 1.

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 w postaci ciągu tekstowego.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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|null – 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getType()`

Pobiera ElementType elementu.

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

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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getVerticalAlignment()`

Pobiera VerticalAlignment.

Powrót

VerticalAlignment|null – wyrównanie w pionie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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|null – szerokość kolumny w punktach.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 w określonym indeksie.

Linia pozioma będzie zawarta w nowym tagu Paragraph.

Parametry

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

Powrót

HorizontalRule – nowa linia pozioma;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 obiektu blob obrazu w określonym indeksie.

Obraz będzie znajdować się w nowym elemencie Paragraph.

Parametry

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

Powrót

InlineImage – wstawiony obraz w treści;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`insertImage(childIndex, image)`

Wstawia podany element InlineImage w określonym indeksie.

Obraz będzie znajdować się w nowym elemencie 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 w treści;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`insertListItem(childIndex, listItem)`

Wstawia podany element ListItem w określonym indeksie.

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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 określonym indeksie.

Parametry

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

Powrót

ListItem – nowy element listy.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`insertParagraph(childIndex, paragraph)`

Wstawia podany element Paragraph w określonym indeksie.

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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 określonym indeksie.

Parametry

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

Powrót

Paragraph – nowy akapit

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 w określonym indeksie.

Parametry

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

Powrót

Table – nowa tabela.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 określone komórki we wskazanym indeksie.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	indeks, w którym ma zostać wstawiony element;
`cells`	`String[][]`	treść tekstową komórek tabeli, która ma zostać dodana do nowej tabeli;

Powrót

Table – nowa tabela.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`insertTable(childIndex, table)`

Wstawia podany element Table w określonym indeksie.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	indeks, w którym ma zostać wstawiony element
`table`	`Table`	tabela do wstawienia,

Powrót

Table – wstawiona tabela.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 – czy element znajduje się na końcu karty.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 są przenoszone do poprzedniego elementu równorzę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|null – scalony element.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`removeFromParent()`

Usuwa element z 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|null – usunięty element.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`replaceText(searchPattern, replacement)`

Zamienia wszystkie wystąpienia danego wzorca tekstu na dany ciąg zastępczy, korzystając z wyrażeń regularnych.

Wzorzec wyszukiwania jest przekazywany jako ciąg znaków, a nie jako obiekt wyrażenia regularnego JavaScript. Dlatego musisz zmienić znaczenie wszystkich ukośników odwrotnych we wzorcu.

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

Podany wzorzec wyrażenia regularnego jest dopasowywany niezależnie 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 zastąpić oryginalny tekst;

Powrót

Element – bieżący element

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setAttributes(attributes)`

Ustawia atrybuty elementu.

Parametr specifiedAttributes musi być obiektem, w którym każda nazwa właściwości jest elementem 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 w formacie notacji CSS (np. `'#ffffff'`);

Powrót

TableCell – bieżący element

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setPaddingBottom(paddingBottom)`

Ustawia dolne dopełnienie w punktach.

Parametry

Nazwa	Typ	Opis
`paddingBottom`	`Number`	dopełnienie u dołu w punktach,

Powrót

TableCell – bieżący element

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setPaddingLeft(paddingLeft)`

Ustawia dopełnienie z lewej strony w punktach.

Parametry

Nazwa	Typ	Opis
`paddingLeft`	`Number`	dopełnienie z lewej strony w punktach,

Powrót

TableCell – bieżący element

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setPaddingRight(paddingRight)`

Ustawia dopełnienie z prawej strony w punktach.

Parametry

Nazwa	Typ	Opis
`paddingRight`	`Number`	Dopełnienie z prawej strony w punktach.

Powrót

TableCell – bieżący element.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setPaddingTop(paddingTop)`

Ustawia górne dopełnienie w punktach.

Parametry

Nazwa	Typ	Opis
`paddingTop`	`Number`	dopełnienie u góry w punktach,

Powrót

TableCell – bieżący element

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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: dotychczasowa zawartość zostanie wyczyszczona.

Parametry

Nazwa	Typ	Opis
`text`	`String`	nową zawartość tekstową,

Powrót

TableCell – bieżący element

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 do zastosowania;

Powrót

TableCell – bieżący element

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

Class TableCell Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Metody

Szczegółowa dokumentacja

appendHorizontalRule()

Powrót

Autoryzacja

appendImage(image)

Parametry

Powrót

Autoryzacja

appendImage(image)

Parametry

Powrót

Autoryzacja

appendListItem(listItem)

Parametry

Powrót

Autoryzacja

appendListItem(text)

Parametry

Powrót

Autoryzacja

appendParagraph(paragraph)

Parametry

Powrót

Autoryzacja

appendParagraph(text)

Parametry

Powrót

Autoryzacja

appendTable()

Powrót

Autoryzacja

appendTable(cells)

Parametry

Powrót

Autoryzacja

appendTable(table)

Parametry

Powrót

Autoryzacja

clear()

Powrót

copy()

Powrót

Autoryzacja

editAsText()

Powrót

findElement(elementType)

Parametry

Powrót

Autoryzacja

findElement(elementType, from)

Parametry

Powrót

Autoryzacja

findText(searchPattern)

Parametry

Powrót

Autoryzacja

findText(searchPattern, from)

Parametry

Powrót

Autoryzacja

getAttributes()

Powrót

Autoryzacja

getBackgroundColor()

Powrót

Autoryzacja

getChild(childIndex)

Parametry

Powrót

Autoryzacja

getChildIndex(child)

Parametry

Powrót

Autoryzacja

getColSpan()

Powrót

Class TableCell

`appendHorizontalRule()`

`appendImage(image)`

`appendImage(image)`

`appendListItem(listItem)`

`appendListItem(text)`

`appendParagraph(paragraph)`

`appendParagraph(text)`

`appendTable()`

`appendTable(cells)`

`appendTable(table)`

`clear()`

`copy()`

`editAsText()`

`findElement(elementType)`

`findElement(elementType, from)`

`findText(searchPattern)`

`findText(searchPattern, from)`

`getAttributes()`

`getBackgroundColor()`

`getChild(childIndex)`

`getChildIndex(child)`

`getColSpan()`

`getLinkUrl()`

`getNextSibling()`

`getNumChildren()`

`getPaddingBottom()`

`getPaddingLeft()`

`getPaddingRight()`

`getPaddingTop()`

`getParent()`

`getParentRow()`

`getParentTable()`

`getPreviousSibling()`

`getRowSpan()`

`getText()`

`getTextAlignment()`

`getType()`

`getVerticalAlignment()`

`getWidth()`

`insertHorizontalRule(childIndex)`

`insertImage(childIndex, image)`

`insertImage(childIndex, image)`

`insertListItem(childIndex, listItem)`

`insertListItem(childIndex, text)`