Class TableCell

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 dokumentów znajdziesz w przewodniku po rozszerzaniu Dokumentów Google.

Metody

MetodaZwracany typKrótki opis
appendHorizontalRule()HorizontalRuleTworzy i dołącza nowy element HorizontalRule.
appendImage(image)InlineImageTworzy i dołącza nowy element InlineImage z określonego obiektu blob obrazu.
appendImage(image)InlineImageDodaje podaną wartość InlineImage.
appendListItem(listItem)ListItemDodaje podaną wartość ListItem.
appendListItem(text)ListItemTworzy i dołącza nowy element ListItem.
appendParagraph(paragraph)ParagraphDodaje podaną wartość Paragraph.
appendParagraph(text)ParagraphTworzy i dołącza nowy element Paragraph.
appendTable()TableTworzy i dołącza nowy element Table.
appendTable(cells)TableDodaje nowy obiekt Table zawierający określone komórki.
appendTable(table)TableDodaje podaną wartość Table.
clear()TableCellCzyści zawartość elementu.
copy()TableCellZwraca odłączoną, głęboką kopię bieżącego elementu.
editAsText()TextPobiera do edycji wersję Text bieżącego elementu.
findElement(elementType)RangeElementPrzeszukuje zawartość elementu pod kątem elementu podrzędnego określonego typu.
findElement(elementType, from)RangeElementPrzeszukuje zawartość elementu pod kątem elementu podrzędnego określonego typu, zaczynając od określonego elementu RangeElement.
findText(searchPattern)RangeElementPrzeszukuje zawartość elementu pod kątem określonego wzorca tekstowego przy użyciu wyrażeń regularnych.
findText(searchPattern, from)RangeElementPrzeszukuje zawartość elementu według określonego wzorca tekstowego, zaczynając od danego wyniku wyszukiwania.
getAttributes()ObjectPobiera atrybuty elementu.
getBackgroundColor()StringPobiera kolor tła.
getChild(childIndex)ElementPobiera element podrzędny z określonego indeksu podrzędnego.
getChildIndex(child)IntegerPobiera indeks podrzędny dla określonego elementu podrzędnego.
getColSpan()IntegerPobiera zakres kolumn, czyli liczbę kolumn komórek tabeli, które obejmuje ta komórka.
getLinkUrl()StringPobiera adres URL linku.
getNextSibling()ElementPobiera następny element równorzędny elementu.
getNumChildren()IntegerPobiera liczbę elementów podrzędnych.
getPaddingBottom()NumberPobiera dolne dopełnienie w punktach.
getPaddingLeft()NumberPobiera lewe dopełnienie w punktach.
getPaddingRight()NumberPobiera właściwe dopełnienie w punktach.
getPaddingTop()NumberPobiera górne dopełnienie w punktach.
getParent()ContainerElementPobiera element nadrzędny elementu.
getParentRow()TableRowPobiera element TableRow zawierający bieżącą wartość TableCell.
getParentTable()TablePobiera element Table zawierający bieżącą wartość TableCell.
getPreviousSibling()ElementPobiera poprzedni element równorzędny.
getRowSpan()IntegerPobiera zakres wiersza, czyli liczbę wierszy komórek tabeli rozciąganych na tę komórkę.
getText()StringPobiera zawartość elementu jako ciąg tekstowy.
getTextAlignment()TextAlignmentWyrównuje tekst.
getType()ElementTypePobiera ElementType elementu.
getVerticalAlignment()VerticalAlignmentPobiera VerticalAlignment.
getWidth()NumberPobiera szerokość kolumny zawierającej komórkę w punktach.
insertHorizontalRule(childIndex)HorizontalRuleTworzy i wstawia nowy element HorizontalRule w określonym indeksie.
insertImage(childIndex, image)InlineImageTworzy i wstawia InlineImage z określonego obiektu blob obrazu o określonym indeksie.
insertImage(childIndex, image)InlineImageWstawia podany InlineImage w określonym indeksie.
insertListItem(childIndex, listItem)ListItemWstawia podany ListItem w określonym indeksie.
insertListItem(childIndex, text)ListItemTworzy i wstawia nowy element ListItem w określonym indeksie.
insertParagraph(childIndex, paragraph)ParagraphWstawia podany Paragraph w określonym indeksie.
insertParagraph(childIndex, text)ParagraphTworzy i wstawia nowy element Paragraph w określonym indeksie.
insertTable(childIndex)TableTworzy i wstawia nowy element Table w określonym indeksie.
insertTable(childIndex, cells)TableTworzy i wstawia nowy element Table zawierający określone komórki w określonym indeksie.
insertTable(childIndex, table)TableWstawia podany Table w określonym indeksie.
isAtDocumentEnd()BooleanOkreś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)TableCellUsuwa określony element podrzędny.
removeFromParent()TableCellUsuwa element z elementu nadrzędnego.
replaceText(searchPattern, replacement)ElementZastępuje wszystkie wystąpienia danego wzorca tekstowego danym zastępczym ciągiem znaków przy użyciu wyrażeń regularnych.
setAttributes(attributes)TableCellUstawia atrybuty elementu.
setBackgroundColor(color)TableCellUstawia kolor tła.
setLinkUrl(url)TableCellUstawia adres URL linku.
setPaddingBottom(paddingBottom)TableCellOkreśla dopełnienie dolne w punktach.
setPaddingLeft(paddingLeft)TableCellUstawia lewe dopełnienie w punktach.
setPaddingRight(paddingRight)TableCellUstawia odpowiednie dopełnienie w punktach.
setPaddingTop(paddingTop)TableCellUstawia dopełnienie u góry w punktach.
setText(text)TableCellUstawia zawartość jako zwykły tekst.
setTextAlignment(textAlignment)TableCellUstawia wyrównanie tekstu.
setVerticalAlignment(alignment)TableCellUstawia wyrównanie w pionie.
setWidth(width)TableCellUstawia szerokość kolumny (w punktach) zawierającej bieżącą komórkę.

Szczegółowa dokumentacja

appendHorizontalRule()

Tworzy i dołącza nowy element HorizontalRule.

Pole HorizontalRule będzie zawarte w nowym obiekcie Paragraph.

Powroty

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 element InlineImage z określonego obiektu blob obrazu.

Pole InlineImage będzie zawarte w nowym obiekcie Paragraph.

Parametry

NazwaTypOpis
imageBlobSourcedane obrazu

Powroty

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 podaną wartość InlineImage.

Pole InlineImage będzie zawarte w nowym obiekcie Paragraph.

Parametry

NazwaTypOpis
imageInlineImagedane obrazu

Powroty

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

Parametry

NazwaTypOpis
listItemListItemelement listy, który ma zostać dołączony

Powroty

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 element ListItem.

Parametry

NazwaTypOpis
textStringzawartość tekstu,

Powroty

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 podaną wartość Paragraph.

Parametry

NazwaTypOpis
paragraphParagraphakapit, który chcesz dołączyć

Powroty

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 element Paragraph.

Parametry

NazwaTypOpis
textStringzawartość tekstu,

Powroty

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 element Table.

Powroty

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

NazwaTypOpis
cellsString[][]zawartość tekstową komórek tabeli, które mają zostać dodane do nowej tabeli;

Powroty

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 podaną wartość Table.

Parametry

NazwaTypOpis
tableTabletabelę do dołączenia

Powroty

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.

Powroty

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.

Powroty

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 do edycji wersję Text bieżącego elementu.

editAsText służy do manipulowania zawartością elementów pod postacią tekstu sformatowanego. Tryb editAsText ignoruje elementy inne niż tekstowe (takie jak InlineImage i HorizontalRule).

Elementy podrzędne w pełni zawarte 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);

Powroty

Text – wersja tekstowa bieżącego elementu;


findElement(elementType)

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

Parametry

NazwaTypOpis
elementTypeElementTypetyp szukanego elementu;

Powroty

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 podrzędnego 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

NazwaTypOpis
elementTypeElementTypetyp szukanego elementu;
fromRangeElementwynik wyszukiwania, który ma być wyszukiwany

Powroty

RangeElement – wynik wyszukiwania wskazujący następną pozycję wyszukiwanego 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

findText(searchPattern)

Przeszukuje zawartość elementu pod kątem określonego wzorca tekstowego przy użyciu wyrażeń regularnych.

Podzbiór funkcji wyrażeń regularnych JavaScript nie jest w pełni obsługiwany, np. grupy przechwytywania i modyfikatory trybów.

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

Parametry

NazwaTypOpis
searchPatternStringwzór do wyszukania

Powroty

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 według określonego wzorca tekstowego, zaczynając od danego wyniku wyszukiwania.

Podzbiór funkcji wyrażeń regularnych JavaScript nie jest w pełni obsługiwany, np. grupy przechwytywania i modyfikatory trybów.

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

Parametry

NazwaTypOpis
searchPatternStringwzór do wyszukania
fromRangeElementwynik wyszukiwania, który ma być wyszukiwany

Powroty

RangeElement – wynik wyszukiwania wskazujący następną pozycję wyszukiwanego tekstu lub wartość null, jeśli nie ma 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]);
}

Powroty

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.

Powroty

String – kolor tła 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

NazwaTypOpis
childIndexIntegerindeks elementu podrzędnego do pobrania

Powroty

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 dla określonego elementu podrzędnego.

Parametry

NazwaTypOpis
childElementelement podrzędny, z którego ma zostać pobrany indeks;

Powroty

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 kolumn, czyli liczbę kolumn komórek tabeli, które obejmuje ta komórka. Niescalone komórki mają zakres kol. 1.

Powroty

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.

Powroty

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ępne elementy nadrzędne mają ten sam element nadrzędny i następują po bieżącym elemencie.

Powroty

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.");

Powroty

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.

Powroty

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.

Powroty

Number – dopełnienie lewe 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 właściwe dopełnienie w punktach.

Powroty

Number – odpowiednie 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.

Powroty

Number – dopełnienie u góry 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 element bieżący.

Powroty

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 element TableRow zawierający bieżącą wartość TableCell.

Powroty

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 element Table zawierający bieżącą wartość TableCell.

Powroty

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.

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

Powroty

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, czyli liczbę wierszy komórek tabeli rozciąganych na tę komórkę. Niescalone komórki mają rozpiętość wierszy wynoszącą 1.

Powroty

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.

Powroty

String – zawartość elementu jako ciąg tekstowy;

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ównuje tekst. Dostępne typy wyrównywania to DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT i DocumentApp.TextAlignment.SUPERSCRIPT.

Powroty

TextAlignment – typ wyrównania tekstu lub null, jeśli tekst zawiera różne rodzaje wyrównania tekstu lub jeśli wyrównanie tekstu nigdy nie został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 ElementType elementu.

Użyj właściwości 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.');
}

Powroty

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.

Powroty

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.

Powroty

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

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

Parametry

NazwaTypOpis
childIndexIntegerindeks, w którym ma zostać wstawiony element

Powroty

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 InlineImage z określonego obiektu blob obrazu o określonym indeksie.

Obraz zostanie umieszczony w nowym elemencie Paragraph.

Parametry

NazwaTypOpis
childIndexIntegerindeks, w którym ma zostać wstawiony element
imageBlobSourcedane obrazu

Powroty

InlineImage – wstawiony obraz w treści;

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

Obraz zostanie umieszczony w nowym elemencie Paragraph.

Parametry

NazwaTypOpis
childIndexIntegerindeks, w którym ma zostać wstawiony element
imageInlineImageobraz do wstawienia

Powroty

InlineImage – wstawiony obraz w treści;

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

Parametry

NazwaTypOpis
childIndexIntegerindeks, w którym ma zostać wstawiony element
listItemListItemelement listy do wstawienia

Powroty

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

Parametry

NazwaTypOpis
childIndexIntegerindeks, w którym ma zostać wstawiony element
textStringzawartość tekstu,

Powroty

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

Parametry

NazwaTypOpis
childIndexIntegerindeks, w którym ma zostać wstawiony element
paragraphParagraphakapit do wstawienia

Powroty

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

Parametry

NazwaTypOpis
childIndexIntegerindeks, w którym ma zostać wstawiony element
textStringzawartość tekstu,

Powroty

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

Parametry

NazwaTypOpis
childIndexIntegerindeks, w którym ma zostać wstawiony element

Powroty

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

NazwaTypOpis
childIndexIntegerindeks, do którego należy wstawić
cellsString[][]zawartość tekstową komórek tabeli, które mają zostać dodane do nowej tabeli;

Powroty

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

Parametry

NazwaTypOpis
childIndexIntegerindeks, w którym ma zostać wstawiony element
tableTabletabelę do wstawienia

Powroty

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.

Powroty

Boolean – określa, 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 elementu 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.

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

Powroty

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

NazwaTypOpis
childElementelement podrzędny do usunięcia

Powroty

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();
}

Powroty

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 tekstowego danym zastępczym ciągiem znaków 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 musisz zmienić znaczenie ukośnika lewego we wzorcu.

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

Podany wzorzec wyrażenia regularnego jest dopasowywany niezależnie do każdego bloku tekstowego 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

NazwaTypOpis
searchPatternStringwzorzec wyrażenia regularnego do wyszukania
replacementStringtekst, który ma zostać użyty jako zamiennik

Powroty

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.

Określony 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

NazwaTypOpis
attributesObjectAtrybuty elementu.

Powroty

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

NazwaTypOpis
colorStringkolor tła w notacji CSS (np. '#ffffff')

Powroty

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

NazwaTypOpis
urlStringadres URL linku

Powroty

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)

Określa dopełnienie dolne w punktach.

Parametry

NazwaTypOpis
paddingBottomNumberdopełnienie dolne, w punktach

Powroty

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 lewe dopełnienie w punktach.

Parametry

NazwaTypOpis
paddingLeftNumberdopełnienie lewe, w punktach

Powroty

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 odpowiednie dopełnienie w punktach.

Parametry

NazwaTypOpis
paddingRightNumberDopełnienie prawe, w punktach.

Powroty

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 dopełnienie u góry w punktach.

Parametry

NazwaTypOpis
paddingTopNumbergórne dopełnienie, w punktach

Powroty

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: dotychczasowe treści zostaną wyczyszczone.

Parametry

NazwaTypOpis
textStringnowa zawartość tekstu,

Powroty

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ównywania 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

NazwaTypOpis
textAlignmentTextAlignmenttyp wyrównania tekstu do zastosowania;

Powroty

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

NazwaTypOpis
alignmentVerticalAlignmentwyrównanie w pionie

Powroty

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 (w punktach) zawierającej bieżącą komórkę.

Parametry

NazwaTypOpis
widthNumberszerokość kolumny w punktach

Powroty

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