Element reprezentujący region tekstu sformatowanego. Cały tekst w elemencie Document
zawiera się w elementach Text
.
Element Text
może się znajdować w elementach Equation
, EquationFunction
, ListItem
lub Paragraph
, ale nie może zawierać żadnych innych elementów. Więcej informacji o strukturze dokumentów znajdziesz w przewodniku po rozszerzeniach Dokumentów Google.
var body = DocumentApp.getActiveDocument().getBody(); // Use editAsText to obtain a single text element containing // all the characters in the document. var text = body.editAsText(); // Insert text at the beginning of the document. text.insertText(0, 'Inserted text.\n'); // Insert text at the end of the document. text.appendText('\nAppended text.'); // Make the first half of the document blue. text.setForegroundColor(0, text.getText().length / 2, '#00FFFF');
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
appendText(text) | Text | Dodaje określony tekst na końcu tego obszaru tekstowego. |
copy() | Text | Zwraca odłączoną głęboką kopię bieżącego elementu. |
deleteText(startOffset, endOffsetInclusive) | Text | Usuwa zakres tekstu. |
editAsText() | Text | Uzyskuje wersję Text bieżącego elementu do edycji. |
findText(searchPattern) | RangeElement | Przeszukuje zawartość elementu w przypadku określonego wzorca tekstu za pomocą wyrażeń regularnych. |
findText(searchPattern, from) | RangeElement | Przeszukuje zawartość elementu w przypadku określonego wzorca tekstu, począwszy od danego wyniku wyszukiwania. |
getAttributes() | Object | Pobiera atrybuty elementu. |
getAttributes(offset) | Object | Pobiera atrybuty z określonym przesunięciem znaku. |
getBackgroundColor() | String | Pobiera ustawienie koloru tła. |
getBackgroundColor(offset) | String | Pobiera kolor tła z uwzględnieniem przesunięcia znaku. |
getFontFamily() | String | Pobiera ustawienie rodziny czcionek. |
getFontFamily(offset) | String | Pobiera rodzinę czcionek z podanym przesunięciem znaków. |
getFontSize() | Number | Pobiera ustawienie rozmiaru czcionki. |
getFontSize(offset) | Number | Pobiera rozmiar czcionki z określonym przesunięciem znaku. |
getForegroundColor() | String | Pobiera ustawienie koloru pierwszego planu. |
getForegroundColor(offset) | String | Pobiera kolor pierwszego planu przy określonej liczbie znaków. |
getLinkUrl() | String | Pobiera adres URL linku. |
getLinkUrl(offset) | String | Pobiera adres URL linku z uwzględnieniem przesunięcia znaku. |
getNextSibling() | Element | Pobiera następny element równorzędny elementu. |
getParent() | ContainerElement | Pobiera element nadrzędny elementu. |
getPreviousSibling() | Element | Pobiera poprzedni element równorzędny elementu. |
getText() | String | Pobiera zawartość elementu jako ciąg tekstowy. |
getTextAlignment() | TextAlignment | Pozwala wyrównać tekst. |
getTextAlignment(offset) | TextAlignment | Pobiera wyrównanie tekstu dla pojedynczego znaku. |
getTextAttributeIndices() | Integer[] | Pobiera zestaw indeksów tekstowych, które odpowiadają początku różnych formatów tekstu. |
getType() | ElementType | Pobiera element ElementType . |
insertText(offset, text) | Text | Wstawia określony tekst z danym przesunięciem znaku. |
isAtDocumentEnd() | Boolean | Określa, czy element znajduje się na końcu elementu Document . |
isBold() | Boolean | Pobiera ustawienie pogrubienia. |
isBold(offset) | Boolean | Pobiera ustawienie pogrubienia z określonym przesunięciem znaków. |
isItalic() | Boolean | Pobiera ustawienie kursywy. |
isItalic(offset) | Boolean | Pobiera ustawienie kursywy dla określonego przesunięcia znaku. |
isStrikethrough() | Boolean | Pobiera ustawienie przekreślenia. |
isStrikethrough(offset) | Boolean | Pobiera przekreślenie z określonym przesunięciem znaku. |
isUnderline() | Boolean | Pobiera ustawienie podkreślenia. |
isUnderline(offset) | Boolean | Pobiera ustawienie podkreślenia z uwzględnieniem przesunięcia znaku. |
merge() | Text | Łączy element z poprzednim elementem tego samego typu. |
removeFromParent() | Text | Usuwa element z elementu nadrzędnego. |
replaceText(searchPattern, replacement) | Element | Zastępuje wszystkie wystąpienia danego wzorca tekstowego przy użyciu określonego ciągu zastępczego, używając wyrażeń regularnych. |
setAttributes(startOffset, endOffsetInclusive, attributes) | Text | Stosuje określone atrybuty do danego zakresu znaków. |
setAttributes(attributes) | Text | Ustawia atrybuty elementu. |
setBackgroundColor(startOffset, endOffsetInclusive, color) | Text | Ustawia kolor tła dla określonego zakresu znaków. |
setBackgroundColor(color) | Text | Ustawia kolor tła. |
setBold(bold) | Text | Ustawia pogrubienie. |
setBold(startOffset, endOffsetInclusive, bold) | Text | Ustawia ustawienie pogrubienia dla określonego zakresu znaków. |
setFontFamily(startOffset, endOffsetInclusive, fontFamilyName) | Text | Ustawia rodzinę czcionek w określonym zakresie znaków. |
setFontFamily(fontFamilyName) | Text | Ustawia rodzinę czcionek. |
setFontSize(startOffset, endOffsetInclusive, size) | Text | Ustawia rozmiar czcionki w określonym zakresie znaków. |
setFontSize(size) | Text | Ustawia rozmiar czcionki. |
setForegroundColor(startOffset, endOffsetInclusive, color) | Text | Ustawia kolor pierwszego planu dla określonego zakresu znaków. |
setForegroundColor(color) | Text | Ustawia kolor pierwszego planu. |
setItalic(italic) | Text | Ustawia ustawienie kursywy. |
setItalic(startOffset, endOffsetInclusive, italic) | Text | Ustawia ustawienie kursywy dla określonego zakresu znaków. |
setLinkUrl(startOffset, endOffsetInclusive, url) | Text | Ustawia URL linku dla określonego zakresu znaków. |
setLinkUrl(url) | Text | Ustawia adres URL linku. |
setStrikethrough(strikethrough) | Text | Ustawia przekreślenie. |
setStrikethrough(startOffset, endOffsetInclusive, strikethrough) | Text | Ustawia przekreślenie dla określonego zakresu znaków. |
setText(text) | Text | Ustawia zawartość tekstową. |
setTextAlignment(startOffset, endOffsetInclusive, textAlignment) | Text | Ustawia wyrównanie tekstu dla danego zakresu znaków. |
setTextAlignment(textAlignment) | Text | Ustawia wyrównanie tekstu. |
setUnderline(underline) | Text | Ustawia podkreślenie. |
setUnderline(startOffset, endOffsetInclusive, underline) | Text | Ustawia ustawienie podkreślenia w wybranym zakresie znaków. |
Szczegółowa dokumentacja
appendText(text)
Dodaje określony tekst na końcu tego obszaru tekstowego.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Adds the text, 'Sample body text,' to the end of the document body. const text = body.editAsText().appendText('Sample body text');
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | Tekst do dołączenia. |
Zwróć
Text
– bieżący element.
Upoważnienie
Skrypty, które używają 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
copy()
Zwraca odłączoną głęboką kopię bieżącego elementu.
Kopiowane są również wszystkie elementy podrzędne zawarte w elemencie. Nowy element nie ma elementu nadrzędnego.
Zwróć
Text
– nowa kopia.
Upoważnienie
Skrypty, które używają 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
deleteText(startOffset, endOffsetInclusive)
Usuwa zakres tekstu.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Deletes the first 10 characters in the body. const text = body.editAsText().deleteText(0, 9);
Parametry
Nazwa | Typ | Opis |
---|---|---|
startOffset | Integer | Odsunięcie pierwszego znaku do usunięcia. |
endOffsetInclusive | Integer | Odsunięcie ostatniego znaku do usunięcia. |
Zwróć
Text
– bieżący element.
Upoważnienie
Skrypty, które używają 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 wersję Text
bieżącego elementu do edycji.
Do manipulowania zawartością elementów jako tekstem sformatowanym służy editAsText
. Tryb editAsText
ignoruje elementy inne niż tekstowe (np. InlineImage
i HorizontalRule
).
Elementy podrzędne w całości zawarte w usuniętym zakresie tekstowym 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);
Zwróć
Text
– wersja tekstowa bieżącego elementu.
findText(searchPattern)
Przeszukuje zawartość elementu w przypadku określonego wzorca tekstu za pomocą wyrażeń regularnych.
Część funkcji wyrażeń regularnych JavaScript, takich jak grupy przechwytywania i modyfikatory trybu, nie jest w pełni obsługiwana.
Podany wzór wyrażenia regularnego jest porównywany niezależnie od każdego bloku tekstowego zawartego w bieżącym elemencie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
searchPattern | String | wzorzec do wyszukania |
Zwróć
RangeElement
– wynik wyszukiwania wskazujący pozycję tekstu lub wartość null w przypadku braku dopasowania;
Upoważnienie
Skrypty, które używają 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 przypadku określonego wzorca tekstu, począwszy od danego wyniku wyszukiwania.
Część funkcji wyrażeń regularnych JavaScript, takich jak grupy przechwytywania i modyfikatory trybu, nie jest w pełni obsługiwana.
Podany wzór wyrażenia regularnego jest porównywany niezależnie od każdego bloku tekstowego zawartego w bieżącym elemencie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
searchPattern | String | wzorzec do wyszukania |
from | RangeElement | wynik wyszukiwania z |
Zwróć
RangeElement
– wynik wyszukiwania wskazujący następną pozycję tekstu wyszukiwania lub wartość null, jeśli nie ma dopasowania
Upoważnienie
Skrypty, które używają 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 powstaje obiekt zawierający właściwość dla każdego prawidłowego atrybutu elementu, w którym 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.
Upoważnienie
Skrypty, które używają 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(offset)
Pobiera atrybuty z określonym przesunięciem znaku.
Wynikiem jest obiekt zawierający właściwość dla każdego prawidłowego atrybutu tekstowego, w której nazwa odpowiada właściwości elementu na liście DocumentApp.Attribute
.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Declares style attributes. const style = {} style[DocumentApp.Attribute.BOLD] = true; style[DocumentApp.Attribute.ITALIC] = true; style[DocumentApp.Attribute.FONT_SIZE] = 29; // Sets the style attributes to the document body. const text = body.editAsText(); text.setAttributes(style); // Gets the style attributes applied to the eleventh character in the // body and logs them to the console. const attributes = text.getAttributes(10); console.log(attributes);
Parametry
Nazwa | Typ | Opis |
---|---|---|
offset | Integer | Odsunięcie znaku. |
Zwróć
Object
– atrybuty elementu.
Upoważnienie
Skrypty, które używają 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 ustawienie koloru tła.
Zwróć
String
– kolor tła w formacie CSS (np. '#ffffff'
) lub pusty, jeśli element zawiera wiele wartości tego atrybutu.
Upoważnienie
Skrypty, które używają 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(offset)
Pobiera kolor tła z uwzględnieniem przesunięcia znaku.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456'); // Gets the document body. const body = doc.getBody(); // Sets the background color of the first 3 characters in the body. const text = body.editAsText().setBackgroundColor(0, 2, '#FFC0CB'); // Gets the background color of the first character in the body. const backgroundColor = text.getBackgroundColor(0); // Logs the background color to the console. console.log(backgroundColor);
Parametry
Nazwa | Typ | Opis |
---|---|---|
offset | Integer | Odsunięcie znaku. |
Zwróć
String
– kolor tła w formacie CSS (np. '#ffffff'
).
Upoważnienie
Skrypty, które używają 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
getFontFamily()
Pobiera ustawienie rodziny czcionek. Możesz wybrać dowolną czcionkę z menu Czcionka w Dokumentach lub Google Fonts. Wielkość liter ma znaczenie. Metody getFontFamily()
i setFontFamily(fontFamilyName)
używają teraz nazw ciągów tekstowych zamiast wyliczenia
. Ta tablica wycofywana jest wciąż dostępna, ale nadal będzie dostępna pod kątem zgodności ze starszymi skryptami.FontFamily
Zwróć
String
– rodzina czcionek lub wartość null, jeśli element zawiera więcej wartości atrybutu.
Upoważnienie
Skrypty, które używają 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
getFontFamily(offset)
Pobiera rodzinę czcionek z podanym przesunięciem znaków. Możesz wpisać dowolną czcionkę z menu Czcionka w Dokumentach lub Google Fonts i rozróżniana jest wielkość liter. Metody getFontFamily()
i setFontFamily(fontFamilyName)
używają teraz nazw ciągów tekstowych zamiast wyliczenia
. Ta tablica wycofywana jest wciąż dostępna, ale nadal będzie dostępna pod kątem zgodności ze starszymi skryptami.
FontFamily
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the font of the first 16 characters to Impact. const text = body.editAsText().setFontFamily(0, 15, 'Impact'); // Gets the font family of the 16th character in the document body. const fontFamily = text.getFontFamily(15); // Logs the font family to the console. console.log(fontFamily);
Parametry
Nazwa | Typ | Opis |
---|---|---|
offset | Integer | Odsunięcie znaku. |
Zwróć
String
– rodzina czcionek,
Upoważnienie
Skrypty, które używają 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
getFontSize()
Pobiera ustawienie rozmiaru czcionki.
Zwróć
Number
– rozmiar czcionki lub wartość null, jeśli element zawiera więcej wartości tego atrybutu
Upoważnienie
Skrypty, które używają 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
getFontSize(offset)
Pobiera rozmiar czcionki z określonym przesunięciem znaku.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the font size of the first 13 characters to 15. const text = body.editAsText().setFontSize(0, 12, 15); // Gets the font size of the first character. const fontSize = text.getFontSize(0); // Logs the font size to the console. console.log(fontSize);
Parametry
Nazwa | Typ | Opis |
---|---|---|
offset | Integer | Odsunięcie znaku. |
Zwróć
Number
– rozmiar czcionki;
Upoważnienie
Skrypty, które używają 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
getForegroundColor()
Pobiera ustawienie koloru pierwszego planu.
Zwróć
String
– kolor pierwszego planu w formacie CSS (np. '#ffffff'
) lub pusty, jeśli element zawiera wiele wartości tego atrybutu
Upoważnienie
Skrypty, które używają 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
getForegroundColor(offset)
Pobiera kolor pierwszego planu przy określonej liczbie znaków.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the foreground color of the first 3 characters in the document body. const text = body.editAsText().setForegroundColor(0, 2, '#0000FF'); // Gets the foreground color of the first character in the document body. const foregroundColor = text.getForegroundColor(0); // Logs the foreground color to the console. console.log(foregroundcolor);
Parametry
Nazwa | Typ | Opis |
---|---|---|
offset | Integer | Odsunięcie znaku. |
Zwróć
String
– kolor pierwszego planu w formacie CSS (np. '#ffffff'
).
Upoważnienie
Skrypty, które używają 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 więcej wartości tego atrybutu
Upoważnienie
Skrypty, które używają 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(offset)
Pobiera adres URL linku z uwzględnieniem przesunięcia znaku.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Applies a link to the first 10 characters in the body. const text = body.editAsText().setLinkUrl(0, 9, 'https://www.example.com/'); // Gets the URL of the link from the first character. const link = text.getLinkUrl(0); // Logs the link URL to the console. console.log(link);
Parametry
Nazwa | Typ | Opis |
---|---|---|
offset | Integer | Odsunięcie znaku. |
Zwróć
String
– adres URL linku,
Upoważnienie
Skrypty, które używają 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 następny element równorzędny elementu.
Następne rodzeństwo ma ten sam element nadrzędny i jest zgodne z bieżącym elementem.
Zwróć
Element
– kolejny element równorzędny
Upoważnienie
Skrypty, które używają 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 elementu.
Element nadrzędny zawiera bieżący element.
Zwróć
ContainerElement
– element nadrzędny.
Upoważnienie
Skrypty, które używają 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 poprzedni element równorzędny elementu.
Poprzednie element równorzędny ma ten sam element nadrzędny i poprzedza bieżący element.
Zwróć
Element
– poprzedni element równorzędny;
Upoważnienie
Skrypty, które używają 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 jako ciąg tekstowy.
Zwróć
String
– zawartość elementu w postaci ciągu tekstowego.
Upoważnienie
Skrypty, które używają 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()
Pozwala wyrównać tekst. Dostępne typy dopasowania 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
Upoważnienie
Skrypty, które używają 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(offset)
Pobiera wyrównanie tekstu dla pojedynczego znaku. Dostępne typy dopasowania to DocumentApp.TextAlignment.NORMAL
, DocumentApp.TextAlignment.SUBSCRIPT
i DocumentApp.TextAlignment.SUPERSCRIPT
.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the text alignment of the document body to NORMAL. const text = body.editAsText().setTextAlignment(DocumentApp.TextAlignment.NORMAL); // Gets the text alignment of the ninth character. const alignment = text.getTextAlignment(8); // Logs the text alignment to the console. console.log(alignment.toString());
Parametry
Nazwa | Typ | Opis |
---|---|---|
offset | Integer | Przesunięcie znaku. |
Zwróć
TextAlignment
– typ dopasowania tekstu lub null
, jeśli wyrównanie tekstu nigdy nie było ustawiane.
Upoważnienie
Skrypty, które używają 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
getTextAttributeIndices()
Pobiera zestaw indeksów tekstowych, które odpowiadają początku różnych formatów tekstu.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Gets the text indices at which text formatting changes. const indices = body.editAsText().getTextAttributeIndices(); // Logs the indices to the console. console.log(indices.toString());
Zwróć
Integer[]
– zestaw indeksów tekstowych, w których zmienia się format tekstu.
Upoważnienie
Skrypty, które używają 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 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.'); }
Zwróć
ElementType
– typ elementu;
Upoważnienie
Skrypty, które używają 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
insertText(offset, text)
Wstawia określony tekst z danym przesunięciem znaku.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Inserts the text, 'Sample inserted text', at the start of the body content. const text = body.editAsText().insertText(0, 'Sample inserted text');
Parametry
Nazwa | Typ | Opis |
---|---|---|
offset | Integer | Odsunięcie znaku, od którego ma zostać wstawiony tekst. |
text | String | Tekst do wstawienia. |
Zwróć
Text
– bieżący element.
Upoważnienie
Skrypty, które używają 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 znajduje się na końcu dokumentu;
Upoważnienie
Skrypty, które używają 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
isBold()
Pobiera ustawienie pogrubienia.
Zwróć
Boolean
– określa, czy tekst jest pogrubiony, czy ma wartość null, jeśli element zawiera wiele wartości tego atrybutu.
Upoważnienie
Skrypty, które używają 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
isBold(offset)
Pobiera ustawienie pogrubienia z określonym przesunięciem znaków.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Bolds the first 4 characters in the document body. const text = body.editAsText().setBold(0, 3, true); // Gets whether or not the text is bold. const bold = text.editAsText().isBold(0); // Logs the text's bold setting to the console console.log(bold);
Parametry
Nazwa | Typ | Opis |
---|---|---|
offset | Integer | Odsunięcie znaku. |
Zwróć
Boolean
– ustawienie pogrubienia.
Upoważnienie
Skrypty, które używają 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
isItalic()
Pobiera ustawienie kursywy.
Zwróć
Boolean
– określa, czy tekst jest zapisany kursywą, czy też ma wartość null.
Upoważnienie
Skrypty, które używają 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
isItalic(offset)
Pobiera ustawienie kursywy dla określonego przesunięcia znaku.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the first 13 characters of the document body to italic. const text = body.editAsText().setItalic(0, 12, true); // Gets whether the fifth character in the document body is set to // italic and logs it to the console. const italic = text.isItalic(4); console.log(italic);
Parametry
Nazwa | Typ | Opis |
---|---|---|
offset | Integer | Odsunięcie znaku. |
Zwróć
Boolean
– ustawienie kursywy.
Upoważnienie
Skrypty, które używają 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
isStrikethrough()
Pobiera ustawienie przekreślenia.
Zwróć
Boolean
– wskazuje, czy tekst jest przekreślony czy pusty, jeśli element zawiera więcej wartości
Upoważnienie
Skrypty, które używają 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
isStrikethrough(offset)
Pobiera przekreślenie z określonym przesunięciem znaku.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the first 17 characters of the document body to strikethrough. const text = body.editAsText().setStrikethrough(0, 16, true); // Gets whether the first character in the document body is set to // strikethrough and logs it to the console. const strikethrough = text.isStrikethrough(0); console.log(strikethrough);
Parametry
Nazwa | Typ | Opis |
---|---|---|
offset | Integer | Odsunięcie znaku. |
Zwróć
Boolean
– przekreślenie,
Upoważnienie
Skrypty, które używają 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
isUnderline()
Pobiera ustawienie podkreślenia.
Zwróć
Boolean
– wskazuje, czy tekst jest podkreślony, czy pusty, jeśli element zawiera kilka wartości tego atrybutu.
Upoważnienie
Skrypty, które używają 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
isUnderline(offset)
Pobiera ustawienie podkreślenia z uwzględnieniem przesunięcia znaku.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the first 13 characters of the document body to underline. const text = body.editAsText().setUnderline(0, 12, false); // Gets whether the first character in the document body is set to // underline and logs it to the console const underline = text.editAsText().isUnderline(0); console.log(underline);
Parametry
Nazwa | Typ | Opis |
---|---|---|
offset | Integer | Odsunięcie znaku. |
Zwróć
Boolean
– ustawienie podkreślenia.
Upoważnienie
Skrypty, które używają 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()
Łączy element z poprzednim elementem tego samego typu.
Łączyć można tylko elementy z tym samym elementem ElementType
. Wszystkie elementy podrzędne zawarte w bieżącym elemencie zostaną przeniesione do poprzedniego elementu równorzędnego.
Bieżący element zostanie usunięty z dokumentu.
var body = DocumentApp.getActiveDocument().getBody(); // Example 1: Merge paragraphs // Append two paragraphs to the document. var par1 = body.appendParagraph('Paragraph 1.'); var par2 = body.appendParagraph('Paragraph 2.'); // Merge the newly added paragraphs into a single paragraph. par2.merge(); // Example 2: Merge table cells // Create a two-dimensional array containing the table's cell contents. var cells = [ ['Row 1, Cell 1', 'Row 1, Cell 2'], ['Row 2, Cell 1', 'Row 2, Cell 2'] ]; // Build a table from the array. var table = body.appendTable(cells); // Get the first row in the table. var row = table.getRow(0); // Get the two cells in this row. var cell1 = row.getCell(0); var cell2 = row.getCell(1); // Merge the current cell into its preceding sibling element. var merged = cell2.merge();
Zwróć
Text
– scalony element,
Upoważnienie
Skrypty, które używają 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óć
Text
– usunięty element.
Upoważnienie
Skrypty, które używają 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)
Zastępuje wszystkie wystąpienia danego wzorca tekstowego przy użyciu określonego ciągu zastępczego, używając wyrażeń regularnych.
Wzorzec wyszukiwania jest przekazywany jako ciąg, a nie obiekt wyrażenia regularnego JavaScript. Z tego powodu musisz unikać w wzorze wzorców ukośników lewym.
Ta metoda korzysta z biblioteki wyrażeń regularnych Google RE2, która ogranicza obsługiwaną składnię.
Podany wzór wyrażenia regularnego jest porównywany niezależnie od 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 być zastąpiony |
Zwróć
Element
– bieżący element;
Upoważnienie
Skrypty, które używają 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(startOffset, endOffsetInclusive, attributes)
Stosuje określone atrybuty do danego zakresu znaków.
Wskazany parametr atrybutów musi być obiektem, w którym każda nazwa właściwości jest elementem listy w DocumentApp.Attribute
, a każda wartość właściwości to nowa wartość do zastosowania.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body and edits as text. const body = doc.getBody().editAsText(); // Declares style attributes for font size and font family. const style = {} style[DocumentApp.Attribute.FONT_SIZE] = 20 ; style[DocumentApp.Attribute.FONT_FAMILY] = 'Impact'; // Sets the style attributes to the first 9 characters in the document body. const text = body.setAttributes(0, 8, style);
Parametry
Nazwa | Typ | Opis |
---|---|---|
startOffset | Integer | Przesunięcie początkowe zakresu tekstowego. |
endOffsetInclusive | Integer | Przesunięcie końcowe zakresu tekstowego. |
attributes | Object | Atrybuty elementu. |
Zwróć
Text
– bieżący element.
Upoważnienie
Skrypty, które używają 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 atrybutów musi być obiektem, w którym każda nazwa właściwości jest elementem listy w 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óć
Text
– bieżący element.
Upoważnienie
Skrypty, które używają 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(startOffset, endOffsetInclusive, color)
Ustawia kolor tła dla określonego zakresu znaków.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the background color of the first 3 characters in the // document body to hex color #0000FF. const text = body.editAsText().setBackgroundColor(0, 2, '#0000FF');
Parametry
Nazwa | Typ | Opis |
---|---|---|
startOffset | Integer | Przesunięcie początkowe zakresu tekstowego. |
endOffsetInclusive | Integer | Przesunięcie końcowe zakresu tekstowego. |
color | String | Kolor tła w formacie notacji CSS (np. '#ffffff' ). |
Zwróć
Text
– bieżący element.
Upoważnienie
Skrypty, które używają 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 formacie notacji CSS (np. '#ffffff' ). |
Zwróć
Text
– bieżący element;
Upoważnienie
Skrypty, które używają 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
setBold(bold)
Ustawia pogrubienie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
bold | Boolean | pogrubienie |
Zwróć
Text
– bieżący element;
Upoważnienie
Skrypty, które używają 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
setBold(startOffset, endOffsetInclusive, bold)
Ustawia ustawienie pogrubienia dla określonego zakresu znaków.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the first 11 characters in the document body to bold. const text = body.editAsText().setBold(0, 10, true);
Parametry
Nazwa | Typ | Opis |
---|---|---|
startOffset | Integer | Przesunięcie początkowe zakresu tekstowego. |
endOffsetInclusive | Integer | Przesunięcie końcowe zakresu tekstowego. |
bold | Boolean | Pogrubienie. |
Zwróć
Text
– bieżący element.
Upoważnienie
Skrypty, które używają 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
setFontFamily(startOffset, endOffsetInclusive, fontFamilyName)
Ustawia rodzinę czcionek w określonym zakresie znaków. Możesz wpisać dowolną czcionkę z menu Czcionka w Dokumentach lub Google Fonts i rozróżniana jest wielkość liter.
Nierozpoznane nazwy czcionek będą renderowane jako CIDR. Metody getFontFamily(offset)
i setFontFamily(fontFamilyName)
używają teraz nazw ciągów tekstowych zamiast wyliczenia
. Ta tablica wycofywana jest wciąż dostępna, ale nadal będzie dostępna pod kątem zgodności ze starszymi skryptami.
FontFamily
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets body of the document. const body = doc.getBody(); // Sets the font of the first 4 characters in the document body to Roboto. const text = body.editAsText().setFontFamily(0, 3, 'Roboto');
Parametry
Nazwa | Typ | Opis |
---|---|---|
startOffset | Integer | Przesunięcie początkowe zakresu tekstowego. |
endOffsetInclusive | Integer | Przesunięcie końcowe zakresu tekstowego. |
fontFamilyName | String | Nazwa rodziny czcionek z menu Czcionka w Dokumentach lub Google Fonts. |
Zwróć
Text
– bieżący element.
Upoważnienie
Skrypty, które używają 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
setFontFamily(fontFamilyName)
Ustawia rodzinę czcionek. Możesz wybrać dowolną czcionkę z menu Czcionka w Dokumentach lub Google Fonts. Wielkość liter ma znaczenie. Nierozpoznane nazwy czcionek będą renderowane jako CIDR. Metody getFontFamily()
i setFontFamily(fontFamilyName)
używają teraz nazw ciągów tekstowych zamiast wyliczenia
. Ta tablica wycofywana jest wciąż dostępna, ale nadal będzie dostępna pod kątem zgodności ze starszymi skryptami.FontFamily
Parametry
Nazwa | Typ | Opis |
---|---|---|
fontFamilyName | String | nazwy rodziny czcionek z menu Czcionka w Dokumentach lub Google Fonts |
Zwróć
Text
– bieżący element;
Upoważnienie
Skrypty, które używają 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
setFontSize(startOffset, endOffsetInclusive, size)
Ustawia rozmiar czcionki w określonym zakresie znaków.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the size of the first 11 characters in the document body to 12. const text = body.editAsText().setFontSize(0, 10, 12);
Parametry
Nazwa | Typ | Opis |
---|---|---|
startOffset | Integer | Przesunięcie początkowe zakresu tekstowego. |
endOffsetInclusive | Integer | Przesunięcie końcowe zakresu tekstowego. |
size | Number | Rozmiar czcionki. |
Zwróć
Text
– bieżący element.
Upoważnienie
Skrypty, które używają 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
setFontSize(size)
Ustawia rozmiar czcionki.
Parametry
Nazwa | Typ | Opis |
---|---|---|
size | Number | rozmiar czcionki; |
Zwróć
Text
– bieżący element;
Upoważnienie
Skrypty, które używają 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
setForegroundColor(startOffset, endOffsetInclusive, color)
Ustawia kolor pierwszego planu dla określonego zakresu znaków.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the foreground color of the first 2 characters in the // document body to hex color #FF0000. const text = body.editAsText().setForegroundColor(0, 1, '#FF0000'); // Gets the foreground color for the second character in the document body. const foregroundColor = text.getForegroundColor(1); // Logs the foreground color to the console. console.log(foregroundColor);
Parametry
Nazwa | Typ | Opis |
---|---|---|
startOffset | Integer | Przesunięcie początkowe zakresu tekstowego. |
endOffsetInclusive | Integer | Przesunięcie końcowe zakresu tekstowego. |
color | String | Kolor pierwszego planu w formacie notacji CSS (np. '#ffffff' ). |
Zwróć
Text
– bieżący element.
Upoważnienie
Skrypty, które używają 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
setForegroundColor(color)
Ustawia kolor pierwszego planu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
color | String | kolor pierwszego planu w formacie notacji CSS (np. '#ffffff' ). |
Zwróć
Text
– bieżący element;
Upoważnienie
Skrypty, które używają 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
setItalic(italic)
Ustawia ustawienie kursywy.
Parametry
Nazwa | Typ | Opis |
---|---|---|
italic | Boolean | ustawienie kursywy |
Zwróć
Text
– bieżący element;
Upoważnienie
Skrypty, które używają 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
setItalic(startOffset, endOffsetInclusive, italic)
Ustawia ustawienie kursywy dla określonego zakresu znaków.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the first 11 characters in the document body to italic. const text = body.editAsText().setItalic(0, 10, true);
Parametry
Nazwa | Typ | Opis |
---|---|---|
startOffset | Integer | Przesunięcie początkowe zakresu tekstowego. |
endOffsetInclusive | Integer | Przesunięcie końcowe zakresu tekstowego. |
italic | Boolean | Ustawienie kursywy. |
Zwróć
Text
– bieżący element.
Upoważnienie
Skrypty, które używają 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(startOffset, endOffsetInclusive, url)
Ustawia URL linku dla określonego zakresu znaków.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Applies a link to the first 11 characters in the body. const text = body.editAsText().setLinkUrl(0, 10, 'https://example.com');
Parametry
Nazwa | Typ | Opis |
---|---|---|
startOffset | Integer | Przesunięcie początkowe zakresu tekstowego. |
endOffsetInclusive | Integer | Przesunięcie końcowe zakresu tekstowego. |
url | String | Adres URL linku. |
Zwróć
Text
– bieżący element.
Upoważnienie
Skrypty, które używają 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 adres URL linku.
Parametry
Nazwa | Typ | Opis |
---|---|---|
url | String | adres URL linku |
Zwróć
Text
– bieżący element;
Upoważnienie
Skrypty, które używają 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
setStrikethrough(strikethrough)
Ustawia przekreślenie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
strikethrough | Boolean | przekreślenie |
Zwróć
Text
– bieżący element;
Upoważnienie
Skrypty, które używają 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
setStrikethrough(startOffset, endOffsetInclusive, strikethrough)
Ustawia przekreślenie dla określonego zakresu znaków.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the first 11 characters in the document body to strikethrough. const text = body.editAsText().setStrikethrough(0, 10, true);
Parametry
Nazwa | Typ | Opis |
---|---|---|
startOffset | Integer | Przesunięcie początkowe zakresu tekstowego. |
endOffsetInclusive | Integer | Przesunięcie końcowe zakresu tekstowego. |
strikethrough | Boolean | Ustawienie przekreślenia. |
Zwróć
Text
– bieżący element.
Upoważnienie
Skrypty, które używają 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ść tekstową.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Replaces the contents of the body with the text, 'New body text.' const text = body.editAsText().setText('New body text.');
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | nowa zawartość tekstowa; |
Zwróć
Text
– bieżący element.
Upoważnienie
Skrypty, które używają 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(startOffset, endOffsetInclusive, textAlignment)
Ustawia wyrównanie tekstu dla danego zakresu znaków. Dostępne typy wyrównania to DocumentApp.TextAlignment.NORMAL
, DocumentApp.TextAlignment.SUBSCRIPT
i DocumentApp.TextAlignment.SUPERSCRIPT
.
// Make the first character in the first paragraph be superscript. var text = DocumentApp.getActiveDocument().getBody().getParagraphs()[0].editAsText(); text.setTextAlignment(0, 0, DocumentApp.TextAlignment.SUPERSCRIPT);
Parametry
Nazwa | Typ | Opis |
---|---|---|
startOffset | Integer | Opóźnienie rozpoczęcia zakresu znaków. |
endOffsetInclusive | Integer | Końcowe przesunięcie zakresu znaków (włącznie). |
textAlignment | TextAlignment | Typ wyrównania tekstu do zastosowania. |
Zwróć
Text
– bieżący element.
Upoważnienie
Skrypty, które używają 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 dopasowania 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 do zastosowania |
Zwróć
Text
– bieżący element;
Upoważnienie
Skrypty, które używają 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
setUnderline(underline)
Ustawia podkreślenie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
underline | Boolean | ustawienie podkreślenia |
Zwróć
Text
– bieżący element;
Upoważnienie
Skrypty, które używają 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
setUnderline(startOffset, endOffsetInclusive, underline)
Ustawia ustawienie podkreślenia w wybranym zakresie znaków.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the first 11 characters in the document body to underline. const text = body.editAsText().setUnderline(0, 10, true);
Parametry
Nazwa | Typ | Opis |
---|---|---|
startOffset | Integer | Przesunięcie początkowe zakresu tekstowego. |
endOffsetInclusive | Integer | Przesunięcie końcowe zakresu tekstowego. |
underline | Boolean | Ustawienie podkreślenia. |
Zwróć
Text
– bieżący element.
Upoważnienie
Skrypty, które używają 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