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

Class TableCell

Element reprezentujący komórkę tabeli. Element TableCell zawsze znajduje się w obrębie znaczników TableRow i może zawierać elementy ListItem, Paragraph lub Table. Więcej informacji na temat struktury dokumentu znajdziesz w przewodniku po rozszerzaniu pliku Dokumentów Google.

Metody

Metoda	Zwracany typ	Krótki opis
`appendHorizontalRule()`	`HorizontalRule`	Tworzy i dołącza nowy obiekt `HorizontalRule`.
`appendImage(image)`	`InlineImage`	Tworzy i dołącza nowy obiekt `InlineImage` z określonego obiektu blob obrazu.
`appendImage(image)`	`InlineImage`	Dodaje podany element `InlineImage`.
`appendListItem(listItem)`	`ListItem`	Dodaje podany element `ListItem`.
`appendListItem(text)`	`ListItem`	Tworzy i dołącza nowy obiekt `ListItem`.
`appendParagraph(paragraph)`	`Paragraph`	Dodaje podany element `Paragraph`.
`appendParagraph(text)`	`Paragraph`	Tworzy i dołącza nowy obiekt `Paragraph`.
`appendTable()`	`Table`	Tworzy i dołącza nowy obiekt `Table`.
`appendTable(cells)`	`Table`	Dodaje nowy obiekt `Table` zawierający określone komórki.
`appendTable(table)`	`Table`	Dodaje podany element `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 elementu podrzędnego określonego typu.
`findElement(elementType, from)`	`RangeElement`	Przeszukuje zawartość elementu pod kątem elementu potomnego określonego typu, zaczynając od określonego elementu `RangeElement`.
`findText(searchPattern)`	`RangeElement`	Przeszukuje zawartość elementu pod kątem określonego wzorca tekstowego przy użyciu wyrażeń regularnych.
`findText(searchPattern, from)`	`RangeElement`	Przeszukuje zawartość elementu pod kątem określonego wzorca 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 z określonego indeksu podrzędnego.
`getChildIndex(child)`	`Integer`	Pobiera indeks podrzędny określonego elementu podrzędnego.
`getColSpan()`	`Integer`	Pobiera zakres kolumny będący liczbą kolumn komórek tabeli, które obejmuje ta komórka.
`getLinkUrl()`	`String`	Pobiera adres URL linku.
`getNextSibling()`	`Element`	Pobiera następny element równorzędny elementu.
`getNumChildren()`	`Integer`	Pobiera liczbę elementów podrzędnych.
`getPaddingBottom()`	`Number`	Pobiera dolne dopełnienie w punktach.
`getPaddingLeft()`	`Number`	Pobiera lewe dopełnienie w punktach.
`getPaddingRight()`	`Number`	Pobiera prawidłowe dopełnienie w punktach.
`getPaddingTop()`	`Number`	Pobiera górne dopełnienie w punktach.
`getParent()`	`ContainerElement`	Pobiera element nadrzędny elementu.
`getParentRow()`	`TableRow`	Pobiera pole `TableRow` zawierające bieżącą wartość `TableCell`.
`getParentTable()`	`Table`	Pobiera pole `Table` zawierające bieżącą wartość `TableCell`.
`getPreviousSibling()`	`Element`	Pobiera poprzedni element równorzędny elementu.
`getRowSpan()`	`Integer`	Pobiera zakres wiersza będący liczbą wierszy komórek tabeli, które obejmuje ta komórka.
`getText()`	`String`	Pobiera zawartość elementu jako ciąg tekstowy.
`getTextAlignment()`	`TextAlignment`	Wyrównanie tekstu.
`getType()`	`ElementType`	Pobiera element `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` o określonym indeksie.
`insertImage(childIndex, image)`	`InlineImage`	Tworzy i wstawia obiekt `InlineImage` z określonego obiektu blob obrazu o określonym indeksie.
`insertImage(childIndex, image)`	`InlineImage`	Wstawia podany element `InlineImage` we wskazanym indeksie.
`insertListItem(childIndex, listItem)`	`ListItem`	Wstawia podany element `ListItem` we wskazanym indeksie.
`insertListItem(childIndex, text)`	`ListItem`	Tworzy i wstawia nowy element `ListItem` o określonym indeksie.
`insertParagraph(childIndex, paragraph)`	`Paragraph`	Wstawia podany element `Paragraph` we wskazanym indeksie.
`insertParagraph(childIndex, text)`	`Paragraph`	Tworzy i wstawia nowy element `Paragraph` o określonym indeksie.
`insertTable(childIndex)`	`Table`	Tworzy i wstawia nowy element `Table` o określonym indeksie.
`insertTable(childIndex, cells)`	`Table`	Tworzy i wstawia nowy element `Table` zawierający określone komórki w określonym indeksie.
`insertTable(childIndex, table)`	`Table`	Wstawia podany element `Table` we wskazanym indeksie.
`isAtDocumentEnd()`	`Boolean`	Określa, czy element znajduje się na końcu parametru `Document`.
`merge()`	`TableCell`	Łączy element z poprzednim elementem równorzędnym tego samego typu.
`removeChild(child)`	`TableCell`	Usuwa określony element podrzędny.
`removeFromParent()`	`TableCell`	Usuwa element z elementu nadrzędnego.
`replaceText(searchPattern, replacement)`	`Element`	Zastępuje wszystkie wystąpienia danego wzorca tekstu określonym ciągiem zastępczym przy użyciu 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 dopełnienie w punktach.
`setPaddingLeft(paddingLeft)`	`TableCell`	Ustawia dopełnienie w punktach po lewej stronie.
`setPaddingRight(paddingRight)`	`TableCell`	Ustawia prawidłowe dopełnienie 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 obiekt HorizontalRule.

Pole HorizontalRule będzie znajdować się w nowym obiekcie Paragraph.

Powrót

HorizontalRule – nowa linia pozioma,

Upoważnienie

Skrypty korzystające z tej 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 dołącza nowy obiekt InlineImage z określonego obiektu blob obrazu.

Pole InlineImage będzie znajdować się w nowym obiekcie Paragraph.

Parametry

Nazwa	Typ	Opis
`image`	`BlobSource`	dane obrazu

Powrót

InlineImage – nowy obraz

Upoważnienie

Skrypty korzystające z tej 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 element InlineImage.

Pole InlineImage będzie znajdować się w nowym obiekcie Paragraph.

Parametry

Nazwa	Typ	Opis
`image`	`InlineImage`	dane obrazu

Powrót

InlineImage – dołączony obraz,

Upoważnienie

Skrypty korzystające z tej 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 element ListItem.

Parametry

Nazwa	Typ	Opis
`listItem`	`ListItem`	element listy, który ma zostać dołączony

Powrót

ListItem – dołączony element listy,

Upoważnienie

Skrypty korzystające z tej 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 dołącza nowy obiekt ListItem.

Parametry

Nazwa	Typ	Opis
`text`	`String`	zawartość tekstu,

Powrót

ListItem – nowy element listy,

Upoważnienie

Skrypty korzystające z tej 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 element Paragraph.

Parametry

Nazwa	Typ	Opis
`paragraph`	`Paragraph`	akapit, który zostanie dołączony

Powrót

Paragraph – dołączony akapit.

Upoważnienie

Skrypty korzystające z tej 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 dołącza nowy obiekt Paragraph.

Parametry

Nazwa	Typ	Opis
`text`	`String`	zawartość tekstu,

Powrót

Paragraph – nowy akapit

Upoważnienie

Skrypty korzystające z tej 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 dołącza nowy obiekt Table.

Powrót

Table – nowa tabela

Upoważnienie

Skrypty korzystające z tej 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 obiekt Table zawierający określone komórki.

Parametry

Nazwa	Typ	Opis
`cells`	`String[][]`	zawartość komórek tabeli, które mają zostać dodane do nowej tabeli

Powrót

Table – dołączona tabela.

Upoważnienie

Skrypty korzystające z tej 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 element Table.

Parametry

Nazwa	Typ	Opis
`table`	`Table`	tabelę do dołączenia

Powrót

Table – dołączona tabela.

Upoważnienie

Skrypty korzystające z tej 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.

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

Powrót

TableCell – nowa kopia.

Upoważnienie

Skrypty korzystające z tej 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.

Użyj metody editAsText, aby edytować zawartość elementów pod postacią tekstu sformatowanego. Tryb editAsText ignoruje elementy inne niż tekstowe (takie jak InlineImage i HorizontalRule).

Elementy podrzędne w całości znajdujące się w usuniętym zakresie tekstu są z niego usuwane.

var body = DocumentApp.getActiveDocument().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 – wersja tekstowa bieżącego elementu,

`findElement(elementType)`

Przeszukuje zawartość elementu pod kątem elementu podrzędnego określonego typu.

Parametry

Nazwa	Typ	Opis
`elementType`	`ElementType`	typ szukanego elementu.

Powrót

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

Upoważnienie

Skrypty korzystające z tej 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 elementu potomnego określonego typu, zaczynając od określonego elementu RangeElement.

// Get the body section of the active document.
var body = DocumentApp.getActiveDocument().getBody();

// Define the search parameters.
var searchType = DocumentApp.ElementType.PARAGRAPH;
var searchHeading = DocumentApp.ParagraphHeading.HEADING1;
var searchResult = null;

// Search until the paragraph is found.
while (searchResult = body.findElement(searchType, searchResult)) {
  var par = searchResult.getElement().asParagraph();
  if (par.getHeading() == searchHeading) {
    // Found one, update and stop.
    par.setText('This is the first header.');
    return;
  }
}

Parametry

Nazwa	Typ	Opis
`elementType`	`ElementType`	typ szukanego elementu.
`from`	`RangeElement`	wynik wyszukiwania, który ma być użyty do wyszukiwania;

Powrót

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

Upoważnienie

Skrypty korzystające z tej 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 przy użyciu wyrażeń regularnych.

Część funkcji wyrażeń regularnych JavaScript nie jest w pełni obsługiwana, np. grupy przechwytywania i modyfikatory trybu.

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

Parametry

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

Powrót

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

Upoważnienie

Skrypty korzystające z tej 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 wzorca tekstowego, zaczynając od danego wyniku wyszukiwania.

Część funkcji wyrażeń regularnych JavaScript nie jest w pełni obsługiwana, np. grupy przechwytywania i modyfikatory trybu.

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

Parametry

Nazwa	Typ	Opis
`searchPattern`	`String`	wzór do wyszukania
`from`	`RangeElement`	wynik wyszukiwania, który ma być użyty do wyszukiwania;

Powrót

RangeElement – wynik wyszukiwania wskazujący następną pozycję wyszukiwanego tekstu lub wartość null, jeśli nie znaleziono żadnego dopasowania.

Upoważnienie

Skrypty korzystające z tej 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.

W efekcie powstanie obiekt zawierający właściwość każdego prawidłowego atrybutu elementu, w którym każda nazwa właściwości odpowiada elementowi w wyliczeniu DocumentApp.Attribute.

var body = DocumentApp.getActiveDocument().getBody();

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

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

// Log the paragraph attributes.
for (var att in atts) {
  Logger.log(att + ":" + atts[att]);
}

Powrót

Object – atrybuty elementu.

Upoważnienie

Skrypty korzystające z tej 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 podany w notacji CSS (np. '#ffffff').

Upoważnienie

Skrypty korzystające z tej 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 z określonego indeksu podrzędnego.

// Get the body section of the active document.
var body = DocumentApp.getActiveDocument().getBody();

// Obtain the first element in the document.
var 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,

Upoważnienie

Skrypty korzystające z tej 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ędny określonego elementu podrzędnego.

Parametry

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

Powrót

Integer – indeks podrzędny,

Upoważnienie

Skrypty korzystające z tej 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 będący liczbą kolumn komórek tabeli, które obejmuje ta komórka. Niescalone komórki mają zakres kolumny równy 1.

Powrót

Integer – zakres kolumny lub 0 w przypadku komórki scalonej przez inną komórkę.

Upoważnienie

Skrypty korzystające z tej 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 wartość null, jeśli element zawiera wiele wartości tego atrybutu

Upoważnienie

Skrypty korzystające z tej 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 równorzędny elementu.

Następny element nadrzędny ma ten sam element nadrzędny i następuje po bieżącym.

Powrót

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

Upoważnienie

Skrypty korzystające z tej 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ę elementów podrzędnych.

// Get the body section of the active document.
var body = DocumentApp.getActiveDocument().getBody();

// Log the number of elements in the document.
Logger.log("There are " + body.getNumChildren() +
    " elements in the document body.");

Powrót

Integer – liczba dzieci;

Upoważnienie

Skrypty korzystające z tej 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 dolne dopełnienie w punktach.

Powrót

Number – dopełnienie u dołu w punktach.

Upoważnienie

Skrypty korzystające z tej 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 lewe dopełnienie w punktach.

Powrót

Number – dopełnienie z lewej strony w punktach.

Upoważnienie

Skrypty korzystające z tej 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 prawidłowe dopełnienie w punktach.

Powrót

Number – właściwe dopełnienie w punktach

Upoważnienie

Skrypty korzystające z tej 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 górne dopełnienie w punktach.

Powrót

Number – dopełnienie u góry strony w punktach

Upoważnienie

Skrypty korzystające z tej 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 elementu.

Element nadrzędny zawiera bieżący element.

Powrót

ContainerElement – element nadrzędny;

Upoważnienie

Skrypty korzystające z tej 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 pole TableRow zawierające bieżącą wartość TableCell.

Powrót

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

Upoważnienie

Skrypty korzystające z tej 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 pole Table zawierające bieżącą wartość TableCell.

Powrót

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

Upoważnienie

Skrypty korzystające z tej 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 równorzędny elementu.

Poprzedni element nadrzędny ma ten sam element nadrzędny i wyprzedza bieżący element.

Powrót

Element – poprzedni element równorzędny.

Upoważnienie

Skrypty korzystające z tej 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 wiersza będący liczbą wierszy komórek tabeli, które obejmuje ta komórka. Niescalone komórki mają rozpiętość wiersza 1.

Powrót

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

Upoważnienie

Skrypty korzystające z tej 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 w postaci ciągu tekstowego,

Upoważnienie

Skrypty korzystające z tej 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()`

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 różne rodzaje wyrównania tekstu lub gdy wyrównanie tekstu nigdy nie było ustawione.

Upoważnienie

Skrypty korzystające z tej 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 element ElementType elementu.

Użyj metody getType(), aby określić dokładny typ danego elementu.

var body = DocumentApp.getActiveDocument().getBody();

// Obtain the first element in the document body.

var 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.

Upoważnienie

Skrypty korzystające z tej 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;

Upoważnienie

Skrypty korzystające z tej 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.

Upoważnienie

Skrypty korzystające z tej 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 o określonym indeksie.

Reguła pozioma będzie znajdować się w nowym elemencie Paragraph.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	indeks, w którym wstawić element

Powrót

HorizontalRule – nowa linia pozioma,

Upoważnienie

Skrypty korzystające z tej 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 obiekt InlineImage z określonego obiektu blob obrazu o określonym indeksie.

Obraz zostanie umieszczony w nowym pliku Paragraph.

Parametry

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

Powrót

InlineImage – wstawiony obraz wbudowany.

Upoważnienie

Skrypty korzystające z tej 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 we wskazanym indeksie.

Obraz zostanie umieszczony w nowym pliku Paragraph.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	indeks, w którym wstawić element
`image`	`InlineImage`	obraz do wstawienia

Powrót

InlineImage – wstawiony obraz wbudowany.

Upoważnienie

Skrypty korzystające z tej 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 we wskazanym indeksie.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	indeks, w którym wstawić element
`listItem`	`ListItem`	element listy do wstawienia

Powrót

ListItem – wstawiono nowy element listy

Upoważnienie

Skrypty korzystające z tej 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 o określonym indeksie.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	indeks, w którym wstawić element
`text`	`String`	zawartość tekstu,

Powrót

ListItem – nowy element listy,

Upoważnienie

Skrypty korzystające z tej 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 we wskazanym indeksie.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	indeks, w którym wstawić element
`paragraph`	`Paragraph`	akapit, który chcesz wstawić

Powrót

Paragraph – wstawiony akapit,

Upoważnienie

Skrypty korzystające z tej 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 o określonym indeksie.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	indeks, w którym wstawić element
`text`	`String`	zawartość tekstu,

Powrót

Paragraph – nowy akapit

Upoważnienie

Skrypty korzystające z tej 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 o określonym indeksie.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	indeks, w którym wstawić element

Powrót

Table – nowa tabela

Upoważnienie

Skrypty korzystające z tej 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 określone komórki w określonym indeksie.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	indeks, do którego należy wstawić
`cells`	`String[][]`	zawartość komórek tabeli, które mają zostać dodane do nowej tabeli

Powrót

Table – nowa tabela

Upoważnienie

Skrypty korzystające z tej 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 we wskazanym indeksie.

Parametry

Nazwa	Typ	Opis
`childIndex`	`Integer`	indeks, w którym wstawić element
`table`	`Table`	tabelę do wstawienia

Powrót

Table – wstawiona tabela.

Upoważnienie

Skrypty korzystające z tej 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 parametru Document.

Powrót

Boolean – wskazuje, czy element znajduje się na końcu dokumentu.

Upoważnienie

Skrypty korzystające z tej 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 równorzędnym tego samego typu.

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

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

var body = DocumentApp.getActiveDocument().getBody();
// Example 1: Merge paragraphs
// Append two paragraphs to the document.
var par1 = body.appendParagraph('Paragraph 1.');
var 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.
var cells = [
['Row 1, Cell 1', 'Row 1, Cell 2'],
['Row 2, Cell 1', 'Row 2, Cell 2']
];
// Build a table from the array.
var table = body.appendTable(cells);
// Get the first row in the table.
 var row = table.getRow(0);
// Get the two cells in this row.
var cell1 = row.getCell(0);
var cell2 = row.getCell(1);
// Merge the current cell into its preceding sibling element.
var merged = cell2.merge();

Powrót

TableCell – scalony element,

Upoważnienie

Skrypty korzystające z tej 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,

Upoważnienie

Skrypty korzystające z tej 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 elementu nadrzędnego.

var body = DocumentApp.getActiveDocument().getBody();

// Remove all images in the document body.
var imgs = body.getImages();
for (var i = 0; i < imgs.length; i++) {
  imgs[i].removeFromParent();
}

Powrót

TableCell – usunięty element.

Upoważnienie

Skrypty korzystające z tej 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)`

Zastępuje wszystkie wystąpienia danego wzorca tekstu określonym ciągiem zastępczym przy użyciu wyrażeń regularnych.

Wzorzec wyszukiwania jest przekazywany jako ciąg znaków, a nie obiekt wyrażenia regularnego JavaScript. Z tego powodu należy stosować we wzorcu ukośnik lewy przed ukośnikiem.

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

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

var body = DocumentApp.getActiveDocument().getBody();

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

Parametry

Nazwa	Typ	Opis
`searchPattern`	`String`	wzorzec wyrażenia regularnego do wyszukania
`replacement`	`String`	tekst, który ma zostać użyty jako zamiennik

Powrót

Element – bieżący element,

Upoważnienie

Skrypty korzystające z tej 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.

Podany parametr atrybutów musi być obiektem, w którym każda nazwa właściwości jest elementem w wyliczeniu DocumentApp.Attribute, a każda wartość właściwości jest nową wartością do zastosowania.

var body = DocumentApp.getActiveDocument().getBody();

// Define a custom paragraph style.
var 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.
var 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.

Upoważnienie

Skrypty korzystające z tej 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 podany w notacji CSS (np. `'#ffffff'`)

Powrót

TableCell – bieżący element,

Upoważnienie

Skrypty korzystające z tej 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,

Upoważnienie

Skrypty korzystające z tej 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 w punktach.

Parametry

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

Powrót

TableCell – bieżący element,

Upoważnienie

Skrypty korzystające z tej 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 dopełnienie w punktach po lewej stronie.

Parametry

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

Powrót

TableCell – bieżący element,

Upoważnienie

Skrypty korzystające z tej 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 prawidłowe dopełnienie w punktach.

Parametry

Nazwa	Typ	Opis
`paddingRight`	`Number`	Prawe dopełnienie w punktach.

Powrót

TableCell – bieżący element.

Upoważnienie

Skrypty korzystające z tej 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 górne dopełnienie w punktach.

Parametry

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

Powrót

TableCell – bieżący element,

Upoważnienie

Skrypty korzystające z tej 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ąca treść zostanie wyczyszczona.

Parametry

Nazwa	Typ	Opis
`text`	`String`	nową zawartość tekstu

Powrót

TableCell – bieżący element,

Upoważnienie

Skrypty korzystające z tej 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 be superscript.
var text = DocumentApp.getActiveDocument().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,

Upoważnienie

Skrypty korzystające z tej 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,

Upoważnienie

Skrypty korzystające z tej 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,

Upoważnienie

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

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