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
Metoda | Zwracany typ | Krótki opis |
---|---|---|
appendHorizontalRule() | HorizontalRule | Tworzy i dołącza nowy element HorizontalRule . |
appendImage(image) | InlineImage | Tworzy i dołącza nowy obiekt InlineImage z określonego bloba obrazu. |
appendImage(image) | InlineImage | Dołącza daną właściwość InlineImage . |
appendListItem(listItem) | ListItem | Dołącza daną właściwość ListItem . |
appendListItem(text) | ListItem | Tworzy i dołącza nowy element ListItem . |
appendParagraph(paragraph) | Paragraph | Dołącza daną właściwość Paragraph . |
appendParagraph(text) | Paragraph | Tworzy i dołącza nowy element Paragraph . |
appendTable() | Table | Tworzy i dołącza nowy element Table . |
appendTable(cells) | Table | Dołącza nowy element Table zawierający określone komórki. |
appendTable(table) | Table | Dołącza daną właściwość Table . |
clear() | TableCell | Czyści zawartość elementu. |
copy() | TableCell | Zwraca odłączoną głęboką kopię bieżącego elementu. |
editAsText() | Text | Uzyskuje do edycji wersję Text bieżącego elementu. |
findElement(elementType) | RangeElement | Wyszukuje zawartość elementu w przypadku elementu potomnego określonego typu. |
findElement(elementType, from) | RangeElement | Wyszukuje zawartość elementu w przypadku potomna określonego typu, począwszy od określonego elementu RangeElement . |
findText(searchPattern) | RangeElement | Przeszukuje zawartość elementu w określonym wzorze tekstowym za pomocą wyrażeń regularnych. |
findText(searchPattern, from) | RangeElement | Przeszukuje zawartość elementu w określonym wzorze tekstu, zaczynając od danego wyniku wyszukiwania. |
getAttributes() | Object | Pobiera atrybuty elementu. |
getBackgroundColor() | String | Pobiera kolor tła. |
getChild(childIndex) | Element | Pobiera element podrzędny w określonym indeksie podrzędnym. |
getChildIndex(child) | Integer | Pobiera indeks podrzędny określonego elementu podrzędnego. |
getColSpan() | Integer | Pobiera rozpiętość kolumny, czyli liczbę kolumn tabeli zawierającej tę komórkę. |
getLinkUrl() | String | Pobiera adres URL linku. |
getNextSibling() | Element | Pobiera element potomny. |
getNumChildren() | Integer | Pobiera liczbę elementów podrzędnych. |
getPaddingBottom() | Number | Pobiera dopełnienie na dole. |
getPaddingLeft() | Number | Pobiera lewe dopełnienie w punktach. |
getPaddingRight() | Number | Pobiera odpowiednie dopełnienie w punktach. |
getPaddingTop() | Number | Pobiera górne dopełnienie w punktach. |
getParent() | ContainerElement | Pobiera element nadrzędny. |
getParentRow() | TableRow | Pobiera TableRow zawierający bieżącą wartość TableCell . |
getParentTable() | Table | Pobiera Table zawierający bieżącą wartość TableCell . |
getPreviousSibling() | Element | Pobiera element potomny. |
getRowSpan() | Integer | Pobiera rozpiętość wierszy, czyli liczbę wierszy tabeli tabeli uwzględnionych przez tę komórkę. |
getText() | String | Pobiera zawartość elementu w postaci ciągu tekstowego. |
getTextAlignment() | TextAlignment | Uzyskaj wyrównanie tekstu. |
getType() | ElementType | Pobiera element ElementType . |
getVerticalAlignment() | VerticalAlignment | Pobiera VerticalAlignment . |
getWidth() | Number | Pobiera w kolumnach szerokość kolumny zawierającej komórkę. |
insertHorizontalRule(childIndex) | HorizontalRule | Tworzy i wstawia nowy indeks HorizontalRule w określonym indeksie. |
insertImage(childIndex, image) | InlineImage | Tworzy i wstawia InlineImage z określonego bloba obrazu w określonym indeksie. |
insertImage(childIndex, image) | InlineImage | Wstawia podaną wartość InlineImage w określonym indeksie. |
insertListItem(childIndex, listItem) | ListItem | Wstawia podaną wartość ListItem w określonym indeksie. |
insertListItem(childIndex, text) | ListItem | Tworzy i wstawia nowy indeks ListItem w określonym indeksie. |
insertParagraph(childIndex, paragraph) | Paragraph | Wstawia podaną wartość Paragraph w określonym indeksie. |
insertParagraph(childIndex, text) | Paragraph | Tworzy i wstawia nowy indeks Paragraph w określonym indeksie. |
insertTable(childIndex) | Table | Tworzy i wstawia nowy indeks Table w określonym indeksie. |
insertTable(childIndex, cells) | Table | Powoduje utworzenie i wstawienie nowego elementu Table zawierającego określone komórki w określonym indeksie. |
insertTable(childIndex, table) | Table | Wstawia podaną wartość Table w określonym indeksie. |
isAtDocumentEnd() | Boolean | Określa, czy element znajduje się na końcu elementu Document . |
merge() | TableCell | Scala element z poprzednim elementem tego samego typu. |
removeChild(child) | TableCell | Usuwa określony element podrzędny. |
removeFromParent() | TableCell | Usuwa element z elementu nadrzędnego. |
replaceText(searchPattern, replacement) | Element | Zamienia wszystkie wystąpienia danego wzorca tekstowego na określony ciąg zastępczy za pomocą wyrażeń regularnych. |
setAttributes(attributes) | TableCell | Ustawia atrybuty elementu. |
setBackgroundColor(color) | TableCell | Ustawia kolor tła. |
setLinkUrl(url) | TableCell | Ustawia URL linku. |
setPaddingBottom(paddingBottom) | TableCell | Ustawia dopełnienie na dole. |
setPaddingLeft(paddingLeft) | TableCell | Ustawia dopełnienie po lewej stronie w punktach. |
setPaddingRight(paddingTop) | TableCell | Ustawia odpowiednie dopełnienie w punktach. |
setPaddingTop(paddingTop) | TableCell | Ustawia dopełnienie na górze. |
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 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
Nazwa | Typ | Opis |
---|---|---|
image | BlobSource | dane 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
Nazwa | Typ | Opis |
---|---|---|
image | InlineImage | dane 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
Nazwa | Typ | Opis |
---|---|---|
listItem | ListItem | elementu 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
Nazwa | Typ | Opis |
---|---|---|
text | String | zawartość 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
Nazwa | Typ | Opis |
---|---|---|
paragraph | Paragraph | akapitu 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
Nazwa | Typ | Opis |
---|---|---|
text | String | zawartość 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()
appendTable(cells)
Dołącza nowy element Table
zawierający określone komórki.
Parametry
Nazwa | Typ | Opis |
---|---|---|
cells | String[][] | 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
Nazwa | Typ | Opis |
---|---|---|
table | Table | tabelę 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()
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
Nazwa | Typ | Opis |
---|---|---|
elementType | ElementType | typ 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
Nazwa | Typ | Opis |
---|---|---|
elementType | ElementType | typ elementu do wyszukania. |
from | RangeElement | wynik 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
Nazwa | Typ | Opis |
---|---|---|
searchPattern | String | wzó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
Nazwa | Typ | Opis |
---|---|---|
searchPattern | String | wzór do wyszukania |
from | RangeElement | wynik 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
Nazwa | Typ | Opis |
---|---|---|
childIndex | Integer | indeks 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
Nazwa | Typ | Opis |
---|---|---|
child | Element | element 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
Nazwa | Typ | Opis |
---|---|---|
childIndex | Integer | indeks, 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
Nazwa | Typ | Opis |
---|---|---|
childIndex | Integer | indeks, do którego należy wstawić element |
image | BlobSource | dane 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
Nazwa | Typ | Opis |
---|---|---|
childIndex | Integer | indeks, do którego należy wstawić element |
image | InlineImage | obraz 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
Nazwa | Typ | Opis |
---|---|---|
childIndex | Integer | indeks, do którego należy wstawić element |
listItem | ListItem | element 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
Nazwa | Typ | Opis |
---|---|---|
childIndex | Integer | indeks, do którego należy wstawić element |
text | String | zawartość 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
Nazwa | Typ | Opis |
---|---|---|
childIndex | Integer | indeks, do którego należy wstawić element |
paragraph | Paragraph | akapitu 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
Nazwa | Typ | Opis |
---|---|---|
childIndex | Integer | indeks, do którego należy wstawić element |
text | String | zawartość 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
Nazwa | Typ | Opis |
---|---|---|
childIndex | Integer | indeks, 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
Nazwa | Typ | Opis |
---|---|---|
childIndex | Integer | indeks, do którego należy wstawić |
cells | String[][] | 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
Nazwa | Typ | Opis |
---|---|---|
childIndex | Integer | indeks, do którego należy wstawić element |
table | Table | tabela 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
Nazwa | Typ | Opis |
---|---|---|
child | Element | element 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
Nazwa | Typ | Opis |
---|---|---|
searchPattern | String | wyrażenie regularne do wyszukania |
replacement | String | tekst, 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
Nazwa | Typ | Opis |
---|---|---|
attributes | Object | Atrybuty 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
Nazwa | Typ | Opis |
---|---|---|
color | String | kolor 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
Nazwa | Typ | Opis |
---|---|---|
url | String | adres 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
Nazwa | Typ | Opis |
---|---|---|
paddingBottom | Number | dolne 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
Nazwa | Typ | Opis |
---|---|---|
paddingLeft | Number | dopeł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
Nazwa | Typ | Opis |
---|---|---|
paddingTop | Number | odpowiednie 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
Nazwa | Typ | Opis |
---|---|---|
paddingTop | Number | dopeł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
Nazwa | Typ | Opis |
---|---|---|
text | String | nowa 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
Nazwa | Typ | Opis |
---|---|---|
textAlignment | TextAlignment | typ 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
Nazwa | Typ | Opis |
---|---|---|
alignment | VerticalAlignment | wyró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
Nazwa | Typ | Opis |
---|---|---|
width | Number | szerokość 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