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