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

Class TableCell

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