Class TableCell

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

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

Metody

MetodaZwracany typKrótki opis
appendHorizontalRule()HorizontalRuleTworzy i dołącza nowy element HorizontalRule.
appendImage(image)InlineImageTworzy i dołącza nowy obiekt InlineImage z określonego bloba obrazu.
appendImage(image)InlineImageDołącza daną właściwość InlineImage.
appendListItem(listItem)ListItemDołącza daną właściwość ListItem.
appendListItem(text)ListItemTworzy i dołącza nowy element ListItem.
appendParagraph(paragraph)ParagraphDołącza daną właściwość Paragraph.
appendParagraph(text)ParagraphTworzy i dołącza nowy element Paragraph.
appendTable()TableTworzy i dołącza nowy element Table.
appendTable(cells)TableDołącza nowy element Table zawierający określone komórki.
appendTable(table)TableDołącza daną właściwość Table.
clear()TableCellCzyści zawartość elementu.
copy()TableCellZwraca odłączoną głęboką kopię bieżącego elementu.
editAsText()TextUzyskuje do edycji wersję Text bieżącego elementu.
findElement(elementType)RangeElementWyszukuje zawartość elementu w przypadku elementu potomnego określonego typu.
findElement(elementType, from)RangeElementWyszukuje zawartość elementu w przypadku potomna określonego typu, począwszy od określonego elementu RangeElement.
findText(searchPattern)RangeElementPrzeszukuje zawartość elementu w określonym wzorze tekstowym za pomocą wyrażeń regularnych.
findText(searchPattern, from)RangeElementPrzeszukuje zawartość elementu w określonym wzorze tekstu, zaczynając od danego wyniku wyszukiwania.
getAttributes()ObjectPobiera atrybuty elementu.
getBackgroundColor()StringPobiera kolor tła.
getChild(childIndex)ElementPobiera element podrzędny w określonym indeksie podrzędnym.
getChildIndex(child)IntegerPobiera indeks podrzędny określonego elementu podrzędnego.
getColSpan()IntegerPobiera rozpiętość kolumny, czyli liczbę kolumn tabeli zawierającej tę komórkę.
getLinkUrl()StringPobiera adres URL linku.
getNextSibling()ElementPobiera element potomny.
getNumChildren()IntegerPobiera liczbę elementów podrzędnych.
getPaddingBottom()NumberPobiera dopełnienie na dole.
getPaddingLeft()NumberPobiera lewe dopełnienie w punktach.
getPaddingRight()NumberPobiera odpowiednie dopełnienie w punktach.
getPaddingTop()NumberPobiera górne dopełnienie w punktach.
getParent()ContainerElementPobiera element nadrzędny.
getParentRow()TableRowPobiera TableRow zawierający bieżącą wartość TableCell.
getParentTable()TablePobiera Table zawierający bieżącą wartość TableCell.
getPreviousSibling()ElementPobiera element potomny.
getRowSpan()IntegerPobiera rozpiętość wierszy, czyli liczbę wierszy tabeli tabeli uwzględnionych przez tę komórkę.
getText()StringPobiera zawartość elementu w postaci ciągu tekstowego.
getTextAlignment()TextAlignmentUzyskaj wyrównanie tekstu.
getType()ElementTypePobiera element ElementType.
getVerticalAlignment()VerticalAlignmentPobiera VerticalAlignment.
getWidth()NumberPobiera w kolumnach szerokość kolumny zawierającej komórkę.
insertHorizontalRule(childIndex)HorizontalRuleTworzy i wstawia nowy indeks HorizontalRule w określonym indeksie.
insertImage(childIndex, image)InlineImageTworzy i wstawia InlineImage z określonego bloba obrazu w określonym indeksie.
insertImage(childIndex, image)InlineImageWstawia podaną wartość InlineImage w określonym indeksie.
insertListItem(childIndex, listItem)ListItemWstawia podaną wartość ListItem w określonym indeksie.
insertListItem(childIndex, text)ListItemTworzy i wstawia nowy indeks ListItem w określonym indeksie.
insertParagraph(childIndex, paragraph)ParagraphWstawia podaną wartość Paragraph w określonym indeksie.
insertParagraph(childIndex, text)ParagraphTworzy i wstawia nowy indeks Paragraph w określonym indeksie.
insertTable(childIndex)TableTworzy i wstawia nowy indeks Table w określonym indeksie.
insertTable(childIndex, cells)TablePowoduje utworzenie i wstawienie nowego elementu Table zawierającego określone komórki w określonym indeksie.
insertTable(childIndex, table)TableWstawia podaną wartość Table w określonym indeksie.
isAtDocumentEnd()BooleanOkreśla, czy element znajduje się na końcu elementu Document.
merge()TableCellScala element z poprzednim elementem tego samego typu.
removeChild(child)TableCellUsuwa określony element podrzędny.
removeFromParent()TableCellUsuwa element z elementu nadrzędnego.
replaceText(searchPattern, replacement)ElementZamienia wszystkie wystąpienia danego wzorca tekstowego na określony ciąg zastępczy za pomocą wyrażeń regularnych.
setAttributes(attributes)TableCellUstawia atrybuty elementu.
setBackgroundColor(color)TableCellUstawia kolor tła.
setLinkUrl(url)TableCellUstawia URL linku.
setPaddingBottom(paddingBottom)TableCellUstawia dopełnienie na dole.
setPaddingLeft(paddingLeft)TableCellUstawia dopełnienie po lewej stronie w punktach.
setPaddingRight(paddingTop)TableCellUstawia odpowiednie dopełnienie w punktach.
setPaddingTop(paddingTop)TableCellUstawia dopełnienie na górze.
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 zawierającej bieżącą komórkę (w punktach).

Szczegółowa dokumentacja

appendHorizontalRule()

Tworzy i dołącza nowy element HorizontalRule.

Element HorizontalRule będzie zawarty w nowym interfejsie Paragraph.

Zwróć

HorizontalRule – nowa reguła pozioma

Autoryzacja

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

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

appendImage(image)

Tworzy i dołącza nowy obiekt InlineImage z określonego bloba obrazu.

Element InlineImage będzie zawarty w nowym interfejsie Paragraph.

Parametry

NazwaTypOpis
imageBlobSourcedane obrazu

Zwróć

InlineImage – nowy obraz

Autoryzacja

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

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

appendImage(image)

Dołącza daną właściwość InlineImage.

Element InlineImage będzie zawarty w nowym interfejsie Paragraph.

Parametry

NazwaTypOpis
imageInlineImagedane obrazu

Zwróć

InlineImage – załączony obraz.

Autoryzacja

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

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

appendListItem(listItem)

Dołącza daną właściwość ListItem.

Parametry

NazwaTypOpis
listItemListItemelementu listy do dołączenia

Zwróć

ListItem – dołączony element listy.

Autoryzacja

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

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

appendListItem(text)

Tworzy i dołącza nowy element ListItem.

Parametry

NazwaTypOpis
textStringzawartość tekstowa

Zwróć

ListItem – nowy element listy

Autoryzacja

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

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

appendParagraph(paragraph)

Dołącza daną właściwość Paragraph.

Parametry

NazwaTypOpis
paragraphParagraphakapitu do dołączenia

Zwróć

Paragraph – dołączony akapit

Autoryzacja

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

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

appendParagraph(text)

Tworzy i dołącza nowy element Paragraph.

Parametry

NazwaTypOpis
textStringzawartość tekstowa

Zwróć

Paragraph – nowy akapit

Autoryzacja

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

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

appendTable()

Tworzy i dołącza nowy element Table.

Zwróć

Table – nowa tabela

Autoryzacja

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

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

appendTable(cells)

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

Parametry

NazwaTypOpis
cellsString[][]zawartość komórek tabeli do dodania do nowej tabeli

Zwróć

Table – dołączona tabela

Autoryzacja

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

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

appendTable(table)

Dołącza daną właściwość Table.

Parametry

NazwaTypOpis
tableTabletabelę do dołączenia

Zwróć

Table – dołączona tabela

Autoryzacja

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

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

clear()

Czyści zawartość elementu.

Zwróć

TableCell – bieżący element


copy()

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

Wszystkie jego elementy podrzędne też zostaną skopiowane. Nowy element nie ma elementu nadrzędnego.

Zwróć

TableCell – nowa kopia.

Autoryzacja

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

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

editAsText()

Uzyskuje do edycji wersję Text bieżącego elementu.

Wartość editAsText służy do manipulowania treścią elementów jako tekst sformatowany. Tryb editAsText ignoruje elementy nietekstowe (np. InlineImage i HorizontalRule).

Elementy podrzędne w całości usuniętego zakresu tekstowego są usuwane z elementu.

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

Zwróć

Text – wersja tekstowa bieżącego elementu.


findElement(elementType)

Wyszukuje zawartość elementu w przypadku elementu potomnego określonego typu.

Parametry

NazwaTypOpis
elementTypeElementTypetyp elementu do wyszukania.

Zwróć

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

Autoryzacja

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

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

findElement(elementType, from)

Wyszukuje zawartość elementu w przypadku potomna określonego typu, począwszy 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 elementu do wyszukania.
fromRangeElementwynik wyszukiwania do wyszukania

Zwróć

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

Autoryzacja

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

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

findText(searchPattern)

Przeszukuje zawartość elementu w określonym wzorze tekstowym za pomocą 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 indywidualnie dopasowywany do każdego bloku tekstowego zawartego w bieżącym elemencie.

Parametry

NazwaTypOpis
searchPatternStringwzór do wyszukania

Zwróć

RangeElement – wynik wyszukiwania wskazujący pozycję wyszukiwanego hasła lub wartość null, jeśli nie ma dopasowania.

Autoryzacja

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

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

findText(searchPattern, from)

Przeszukuje zawartość elementu w określonym wzorze tekstu, 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 indywidualnie dopasowywany do każdego bloku tekstowego zawartego w bieżącym elemencie.

Parametry

NazwaTypOpis
searchPatternStringwzór do wyszukania
fromRangeElementwynik wyszukiwania do wyszukania

Zwróć

RangeElement – wynik wyszukiwania wskazujący następną pozycję wyszukiwanego hasła lub wartość null w przypadku braku dopasowania.

Autoryzacja

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

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

getAttributes()

Pobiera atrybuty elementu.

W rezultacie obiekt zawiera właściwość dla każdego prawidłowego atrybutu elementu, gdzie każda nazwa właściwości odpowiada elementowi na liście 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]);
}

Zwróć

Object – atrybuty elementu

Autoryzacja

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

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

getBackgroundColor()

Pobiera kolor tła.

Zwróć

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

Autoryzacja

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

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

getChild(childIndex)

Pobiera element podrzędny w określonym indeksie podrzędnym.

// 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

Zwróć

Element – element podrzędny w określonym indeksie,

Autoryzacja

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

NazwaTypOpis
childElementelement podrzędny, dla którego zostanie pobrany indeks

Zwróć

Integer – indeks podrzędny

Autoryzacja

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

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

getColSpan()

Pobiera rozpiętość kolumny, czyli liczbę kolumn tabeli zawierającej tę komórkę. Niescalone komórki mają rozpiętość rzędu 1.

Zwróć

Integer – zakres kolumny lub wartość 0 w przypadku komórki, która została scalona przez inną komórkę;

Autoryzacja

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

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

getLinkUrl()

Pobiera adres URL linku.

Zwróć

String – URL linku lub wartość null (jeśli element zawiera wiele wartości tego atrybutu)

Autoryzacja

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

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

getNextSibling()

Pobiera element potomny.

Kolejne rodzeństwo ma tego samego elementu nadrzędnego i jednocześnie występuje w bieżącym elemencie.

Zwróć

Element – następny element potomny

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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.");

Zwróć

Integer – liczba dzieci

Autoryzacja

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

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

getPaddingBottom()

Pobiera dopełnienie na dole.

Zwróć

Number – dopełnienie na dole (w punktach),

Autoryzacja

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

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

getPaddingLeft()

Pobiera lewe dopełnienie w punktach.

Zwróć

Number – lewe dopełnienie w punktach,

Autoryzacja

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

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

getPaddingRight()

Pobiera odpowiednie dopełnienie w punktach.

Zwróć

Number – odpowiednie dopełnienie w punktach,

Autoryzacja

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

Zwróć

Number – górne dopełnienie w punktach

Autoryzacja

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

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

getParent()

Pobiera element nadrzędny.

Element nadrzędny zawiera bieżący element.

Zwróć

ContainerElement – element nadrzędny;

Autoryzacja

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

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

getParentRow()

Pobiera TableRow zawierający bieżącą wartość TableCell.

Zwróć

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

Autoryzacja

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

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

getParentTable()

Pobiera Table zawierający bieżącą wartość TableCell.

Zwróć

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

Autoryzacja

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

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

getPreviousSibling()

Pobiera element potomny.

Poprzednie rodzeństwo ma ten sam element nadrzędny i wyprzedza bieżący element.

Zwróć

Element – poprzedni element równorzędny.

Autoryzacja

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

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

getRowSpan()

Pobiera rozpiętość wierszy, czyli liczbę wierszy tabeli tabeli uwzględnionych przez tę komórkę. Niescalone komórki mają rozpiętość wierszy równą 1.

Zwróć

Integer – rozpiętość wiersza lub 0 dla komórki, która została scalona przez inną komórkę;

Autoryzacja

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

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

getText()

Pobiera zawartość elementu w postaci ciągu tekstowego.

Zwróć

String – zawartość elementu w postaci ciągu tekstowego;

Autoryzacja

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

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

getTextAlignment()

Uzyskaj wyrównanie tekstu. Dostępne typy wyrównania to DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT i DocumentApp.TextAlignment.SUPERSCRIPT.

Zwróć

TextAlignment – typ wyrównania tekstu lub null, jeśli tekst zawiera wiele typów wyrównania tekstu lub jeśli wyrównanie tekstu nigdy nie zostało ustawione.

Autoryzacja

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

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

getType()

Pobiera element ElementType.

Użyj właściwości getType(), aby dokładnie określić 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.');
}

Zwróć

ElementType – typ elementu;

Autoryzacja

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

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

getVerticalAlignment()

Pobiera VerticalAlignment.

Zwróć

VerticalAlignment – wyrównanie w pionie

Autoryzacja

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

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

getWidth()

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

Zwróć

Number – szerokość kolumny w punktach,

Autoryzacja

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

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

insertHorizontalRule(childIndex)

Tworzy i wstawia nowy indeks HorizontalRule w określonym indeksie.

Reguła pozioma zostanie dodana do nowej właściwości Paragraph.

Parametry

NazwaTypOpis
childIndexIntegerindeks, do którego należy wstawić element

Zwróć

HorizontalRule – nowa reguła pozioma

Autoryzacja

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

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

insertImage(childIndex, image)

Tworzy i wstawia InlineImage z określonego bloba obrazu w określonym indeksie.

Obraz zostanie umieszczony w nowym pliku Paragraph.

Parametry

NazwaTypOpis
childIndexIntegerindeks, do którego należy wstawić element
imageBlobSourcedane obrazu

Zwróć

InlineImage – wstawiony obraz wbudowany

Autoryzacja

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

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

insertImage(childIndex, image)

Wstawia podaną wartość InlineImage w określonym indeksie.

Obraz zostanie umieszczony w nowym pliku Paragraph.

Parametry

NazwaTypOpis
childIndexIntegerindeks, do którego należy wstawić element
imageInlineImageobraz do wstawienia

Zwróć

InlineImage – wstawiony obraz wbudowany

Autoryzacja

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

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

insertListItem(childIndex, listItem)

Wstawia podaną wartość ListItem w określonym indeksie.

Parametry

NazwaTypOpis
childIndexIntegerindeks, do którego należy wstawić element
listItemListItemelement listy do wstawienia

Zwróć

ListItem – wstawiono nowy element listy

Autoryzacja

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

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

insertListItem(childIndex, text)

Tworzy i wstawia nowy indeks ListItem w określonym indeksie.

Parametry

NazwaTypOpis
childIndexIntegerindeks, do którego należy wstawić element
textStringzawartość tekstowa

Zwróć

ListItem – nowy element listy

Autoryzacja

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

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

insertParagraph(childIndex, paragraph)

Wstawia podaną wartość Paragraph w określonym indeksie.

Parametry

NazwaTypOpis
childIndexIntegerindeks, do którego należy wstawić element
paragraphParagraphakapitu do wstawienia

Zwróć

Paragraph – wstawiony akapit

Autoryzacja

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

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

insertParagraph(childIndex, text)

Tworzy i wstawia nowy indeks Paragraph w określonym indeksie.

Parametry

NazwaTypOpis
childIndexIntegerindeks, do którego należy wstawić element
textStringzawartość tekstowa

Zwróć

Paragraph – nowy akapit

Autoryzacja

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

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

insertTable(childIndex)

Tworzy i wstawia nowy indeks Table w określonym indeksie.

Parametry

NazwaTypOpis
childIndexIntegerindeks, do którego należy wstawić element

Zwróć

Table – nowa tabela

Autoryzacja

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

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

insertTable(childIndex, cells)

Powoduje utworzenie i wstawienie nowego elementu Table zawierającego określone komórki w określonym indeksie.

Parametry

NazwaTypOpis
childIndexIntegerindeks, do którego należy wstawić
cellsString[][]zawartość komórek tabeli do dodania do nowej tabeli

Zwróć

Table – nowa tabela

Autoryzacja

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

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

insertTable(childIndex, table)

Wstawia podaną wartość Table w określonym indeksie.

Parametry

NazwaTypOpis
childIndexIntegerindeks, do którego należy wstawić element
tableTabletabela do wstawienia

Zwróć

Table – wstawiono tabelę

Autoryzacja

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

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

isAtDocumentEnd()

Określa, czy element znajduje się na końcu elementu Document.

Zwróć

Boolean – określa, czy element jest na końcu dokumentu –

Autoryzacja

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

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

merge()

Scala element z poprzednim elementem tego samego typu.

Łączyć można tylko te same elementy ElementType. Wszystkie elementy podrzędne zawarte w bieżącym elemencie są przenoszone do elementu nadrzę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();

Zwróć

TableCell – scalony element;

Autoryzacja

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

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

removeChild(child)

Usuwa określony element podrzędny.

Parametry

NazwaTypOpis
childElementelement podrzędny do usunięcia

Zwróć

TableCell – bieżący element

Autoryzacja

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

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

removeFromParent()

Usuwa element z elementu nadrzędnego.

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

Zwróć

TableCell – usunięty element;

Autoryzacja

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

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

replaceText(searchPattern, replacement)

Zamienia wszystkie wystąpienia danego wzorca tekstowego na określony ciąg zastępczy za pomocą wyrażeń regularnych.

Wzorzec wyszukiwania jest przekazywany jako ciąg znaków, a nie obiekt wyrażenia regularnego JavaScript. Z tego powodu trzeba uniknąć zmiany ukośników we wzorze.

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

Podany wzorzec wyrażenia regularnego jest indywidualnie 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

NazwaTypOpis
searchPatternStringwyrażenie regularne do wyszukania
replacementStringtekst, który ma być używany jako zamiennik.

Zwróć

Element – bieżący element

Autoryzacja

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

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

setAttributes(attributes)

Ustawia atrybuty elementu.

Wskazany parametr musi być obiektem, w którym każda nazwa właściwości jest elementem w wyliczeniach DocumentApp.Attribute, a każda wartość właściwości to nowa wartość 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.

Zwróć

TableCell – bieżący element.

Autoryzacja

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

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

setBackgroundColor(color)

Ustawia kolor tła.

Parametry

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

Zwróć

TableCell – bieżący element

Autoryzacja

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

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

setLinkUrl(url)

Ustawia URL linku.

Parametry

NazwaTypOpis
urlStringadres URL linku

Zwróć

TableCell – bieżący element

Autoryzacja

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

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

setPaddingBottom(paddingBottom)

Ustawia dopełnienie na dole.

Parametry

NazwaTypOpis
paddingBottomNumberdolne dopełnienie (w punktach)

Zwróć

TableCell – bieżący element

Autoryzacja

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

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

setPaddingLeft(paddingLeft)

Ustawia dopełnienie po lewej stronie w punktach.

Parametry

NazwaTypOpis
paddingLeftNumberdopełnienie z lewej, w punktach

Zwróć

TableCell – bieżący element

Autoryzacja

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

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

setPaddingRight(paddingTop)

Ustawia odpowiednie dopełnienie w punktach.

Parametry

NazwaTypOpis
paddingTopNumberodpowiednie dopełnienie w punktach

Zwróć

TableCell – bieżący element

Autoryzacja

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

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

setPaddingTop(paddingTop)

Ustawia dopełnienie na górze.

Parametry

NazwaTypOpis
paddingTopNumberdopełnienie górne w punktach

Zwróć

TableCell – bieżący element

Autoryzacja

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

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

setText(text)

Ustawia zawartość jako zwykły tekst.

Uwaga: istniejąca zawartość zostanie wyczyszczona.

Parametry

NazwaTypOpis
textStringnowa zawartość tekstowa

Zwróć

TableCell – bieżący element

Autoryzacja

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

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

setTextAlignment(textAlignment)

Ustawia wyrównanie tekstu. Dostępne typy wyrównania to DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT i DocumentApp.TextAlignment.SUPERSCRIPT.

// Make the entire first paragraph be superscript.
var text = DocumentApp.getActiveDocument().getBody().getParagraphs()[0].editAsText();
text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);

Parametry

NazwaTypOpis
textAlignmentTextAlignmenttyp dopasowania tekstu, który ma zostać zastosowany

Zwróć

TableCell – bieżący element

Autoryzacja

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

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

setVerticalAlignment(alignment)

Ustawia wyrównanie w pionie.

Parametry

NazwaTypOpis
alignmentVerticalAlignmentwyrównanie w pionie

Zwróć

TableCell – bieżący element

Autoryzacja

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

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

setWidth(width)

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

Parametry

NazwaTypOpis
widthNumberszerokość kolumny w punktach

Zwróć

TableCell – bieżący element

Autoryzacja

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

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