Class Text

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

Element reprezentujący region tekstu sformatowanego. Tekst w elemencie Document jest zawarty w elementach Text. Element Text może znajdować się w tagu 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

MetodaZwracany typKrótki opis
appendText(text)TextDodaje określony tekst na końcu tego obszaru tekstowego.
copy()TextZwraca odłączoną głęboką kopię bieżącego elementu.
deleteText(startOffset, endOffsetInclusive)TextUsuwa zakres tekstu.
editAsText()TextUzyskuje do edycji wersję Text bieżącego elementu.
findText(searchPattern)RangeElementPrzeszukuje zawartość elementu w określonym wzorze tekstowym za pomocą wyrażeń regularnych.
findText(searchPattern, from)RangeElementPrzeszukuje zawartość elementu w określonym wzorze tekstu, zaczynając od danego wyniku wyszukiwania.
getAttributes()ObjectPobiera atrybuty elementu.
getAttributes(offset)ObjectPobiera atrybuty z określonym przesunięciem znaku.
getBackgroundColor()StringPobiera ustawienie koloru tła.
getBackgroundColor(offset)StringPobiera kolor tła przy określonym przesunięcia znaków.
getFontFamily()StringPobiera ustawienie rodziny czcionek.
getFontFamily(offset)StringPobiera rodzinę czcionek przy określonym przesunięcia znaków.
getFontSize()NumberPobiera ustawienie rozmiaru czcionki.
getFontSize(offset)NumberPobiera rozmiar czcionki dla określonego przesunięcia znaków.
getForegroundColor()StringPobiera ustawienie kolorów pierwszego planu.
getForegroundColor(offset)StringPobiera kolor pierwszego planu przy określonym przesunięcia znaków.
getLinkUrl()StringPobiera adres URL linku.
getLinkUrl(offset)StringPobiera adres URL linku z określonym przesunięciem liczby znaków.
getNextSibling()ElementPobiera element potomny.
getParent()ContainerElementPobiera element nadrzędny.
getPreviousSibling()ElementPobiera element potomny.
getText()StringPobiera zawartość elementu w postaci ciągu tekstowego.
getTextAlignment()TextAlignmentUzyskaj wyrównanie tekstu.
getTextAlignment(offset)TextAlignmentPobieranie wyrównania tekstu dla pojedynczego znaku.
getTextAttributeIndices()Integer[]Pobiera zestaw indeksów tekstowych odpowiadających początku wybranego formatowania.
getType()ElementTypePobiera element ElementType.
insertText(offset, text)TextWstawia określony tekst w przypadku danego przesunięcia znaku.
isAtDocumentEnd()BooleanOkreśla, czy element znajduje się na końcu elementu Document.
isBold()BooleanPobiera ustawienie pogrubienia.
isBold(offset)BooleanPobiera ustawienie pogrubienia z uwzględnieniem określonego przesunięcia znaków.
isItalic()BooleanPowoduje pobranie ustawienia kursywy.
isItalic(offset)BooleanPobiera ustawienie kursywy z określonym przesunięciem znaków.
isStrikethrough()BooleanPobiera ustawienie przekreślenia.
isStrikethrough(offset)BooleanPobiera ustawienie przekreślenia z określonym przesunięciem znaku.
isUnderline()BooleanPobiera ustawienie podkreślenia.
isUnderline(offset)BooleanPobiera ustawienie podkreślenia z określonym przesunięciem znaku.
merge()TextScala element z poprzednim elementem tego samego typu.
removeFromParent()TextUsuwa element z elementu nadrzędnego.
replaceText(searchPattern, replacement)ElementZamienia wszystkie wystąpienia danego wzorca tekstowego na określony ciąg zastępczy za pomocą wyrażeń regularnych.
setAttributes(startOffset, endOffsetInclusive, attributes)TextStosuje określone atrybuty do danego zakresu znaków.
setAttributes(attributes)TextUstawia atrybuty elementu.
setBackgroundColor(startOffset, endOffsetInclusive, color)TextUstawia kolor tła określonego zakresu znaków.
setBackgroundColor(color)TextUstawia kolor tła.
setBold(bold)TextUstawia pogrubienie.
setBold(startOffset, endOffsetInclusive, bold)TextUstawia pogrubienie na potrzeby określonego zakresu znaków.
setFontFamily(startOffset, endOffsetInclusive, fontFamilyName)TextUstawia rodzinę czcionek w określonym zakresie znaków.
setFontFamily(fontFamilyName)TextUstawia rodzinę czcionek.
setFontSize(startOffset, endOffsetInclusive, size)TextUstawia rozmiar czcionki w określonym zakresie znaków.
setFontSize(size)TextUstawia rozmiar czcionki.
setForegroundColor(startOffset, endOffsetInclusive, color)TextUstawia kolor pierwszego planu dla określonego zakresu znaków.
setForegroundColor(color)TextUstawia kolor pierwszego planu.
setItalic(italic)TextPowoduje ustawienie kursywy.
setItalic(startOffset, endOffsetInclusive, italic)TextUstawia ustawienie kursywy dla określonego zakresu znaków.
setLinkUrl(startOffset, endOffsetInclusive, url)TextUstawia adres URL linku dla określonego zakresu znaków.
setLinkUrl(url)TextUstawia URL linku.
setStrikethrough(strikethrough)TextUstawia przekreślenie.
setStrikethrough(startOffset, endOffsetInclusive, strikethrough)TextUstawia przekreślenie dla określonego zakresu znaków.
setText(text)TextUstawia zawartość tekstową.
setTextAlignment(startOffset, endOffsetInclusive, textAlignment)TextUstawia wyrównanie tekstu w danym zakresie znaków.
setTextAlignment(textAlignment)TextUstawia wyrównanie tekstu.
setUnderline(underline)TextUstawia ustawienie podkreślenia.
setUnderline(startOffset, endOffsetInclusive, underline)TextUstawia podkreślenie określonego zakresu znaków.

Szczegółowa dokumentacja

appendText(text)

Dodaje określony tekst na końcu tego obszaru tekstowego.

Parametry

NazwaTypOpis
textStringtekst do dodania

Zwróć

Text – 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

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

Text – 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

deleteText(startOffset, endOffsetInclusive)

Usuwa zakres tekstu.

Parametry

NazwaTypOpis
startOffsetIntegerprzesunięcie pierwszego znaku do usunięcia
endOffsetInclusiveIntegerprzesunięcie znaku do ostatniego znaku do usunięcia

Zwróć

Text – 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

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.


findText(searchPattern)

Przeszukuje zawartość elementu w określonym wzorze tekstowym za pomocą wyrażeń regularnych.

Część funkcji wyrażeń regularnych JavaScript nie jest w pełni obsługiwana, np. grupy przechwytywania i modyfikatory trybu.

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

Parametry

NazwaTypOpis
searchPatternStringwzór do wyszukania

Zwróć

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

Autoryzacja

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

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

findText(searchPattern, from)

Przeszukuje zawartość elementu w określonym wzorze tekstu, zaczynając od danego wyniku wyszukiwania.

Część funkcji wyrażeń regularnych JavaScript nie jest w pełni obsługiwana, np. grupy przechwytywania i modyfikatory trybu.

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

Parametry

NazwaTypOpis
searchPatternStringwzór do wyszukania
fromRangeElementwynik wyszukiwania do wyszukania

Zwróć

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

Autoryzacja

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

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

getAttributes()

Pobiera atrybuty elementu.

W rezultacie obiekt zawiera właściwość dla każdego prawidłowego atrybutu elementu, gdzie każda nazwa właściwości odpowiada elementowi na liście DocumentApp.Attribute.

var body = DocumentApp.getActiveDocument().getBody();

// Append a styled paragraph.
var par = body.appendParagraph('A bold, italicized paragraph.');
par.setBold(true);
par.setItalic(true);

// Retrieve the paragraph's attributes.
var atts = par.getAttributes();

// Log the paragraph attributes.
for (var att in atts) {
  Logger.log(att + ":" + atts[att]);
}

Zwróć

Object – atrybuty elementu

Autoryzacja

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

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

getAttributes(offset)

Pobiera atrybuty z określonym przesunięciem znaku.

W rezultacie obiekt zawiera właściwość dla każdego prawidłowego atrybutu tekstowego, gdzie każda nazwa właściwości odpowiada elementowi na liście DocumentApp.Attribute.

Parametry

NazwaTypOpis
offsetIntegerprzesunięcie znaków

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 ustawienie koloru tła.

Zwróć

String – kolor tła w formacie notacji CSS (np. '#ffffff') lub wartość null (jeśli element zawiera wiele wartości)

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

Pobiera kolor tła przy określonym przesunięcia znaków.

Parametry

NazwaTypOpis
offsetIntegerprzesunięcie znaków

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

getFontFamily()

Pobiera ustawienie rodziny czcionek. Może to być dowolna czcionka w menu Czcionka w Dokumentach lub Czcionki Google. Wielkość liter ma znaczenie. Metody getFontFamily() i setFontFamily(fontFamilyName) używają teraz nazw ciągów tekstowych dla czcionek zamiast wyliczenia FontFamily. Mimo że ta wartość typu enum została wycofana, będzie nadal dostępna dla zgodności ze starszymi skryptami.

Zwróć

String – rodzina czcionek 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

getFontFamily(offset)

Pobiera rodzinę czcionek przy określonym przesunięcia znaków. Może to być dowolna czcionka w menu czcionek w Dokumentach lub Czcionki Google. Wielkość liter jest rozróżniana. Metody getFontFamily() i setFontFamily(fontFamilyName) używają teraz nazw ciągów znaków dla czcionek zamiast wyliczenia FontFamily. Mimo że ta wartość typu enum została wycofana, będzie nadal dostępna dla zgodności ze starszymi skryptami.

Parametry

NazwaTypOpis
offsetIntegerprzesunięcie znaków

Zwróć

String – rodzina czcionek,

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

getFontSize()

Pobiera ustawienie rozmiaru czcionki.

Zwróć

Number – rozmiar czcionki lub wartość null w przypadku, gdy element zawiera więcej 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

getFontSize(offset)

Pobiera rozmiar czcionki dla określonego przesunięcia znaków.

Parametry

NazwaTypOpis
offsetIntegerprzesunięcie znaków

Zwróć

Number – rozmiar czcionki.

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

getForegroundColor()

Pobiera ustawienie kolorów pierwszego planu.

Zwróć

String – kolor pierwszego planu w formacie notacji CSS (np. '#ffffff') 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

getForegroundColor(offset)

Pobiera kolor pierwszego planu przy określonym przesunięcia znaków.

Parametry

NazwaTypOpis
offsetIntegerprzesunięcie znaków

Zwróć

String – kolor pierwszego planu sformatowany 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

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

getLinkUrl(offset)

Pobiera adres URL linku z określonym przesunięciem liczby znaków.

Parametry

NazwaTypOpis
offsetIntegerprzesunięcie znaków

Zwróć

String – adres URL linku

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

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

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

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

getTextAlignment(offset)

Pobieranie wyrównania tekstu dla pojedynczego znaku. Dostępne typy wyrównania to DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT i DocumentApp.TextAlignment.SUPERSCRIPT.

Parametry

NazwaTypOpis
offsetIntegerprzesunięcie znaku

Zwróć

TextAlignment – typ wyrównania tekstu lub null, 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

getTextAttributeIndices()

Pobiera zestaw indeksów tekstowych odpowiadających początku wybranego formatowania.

Zwróć

Integer[] – zbiór indeksów tekstowych, w których przypadku zmienia się formatowanie tekstu.

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

insertText(offset, text)

Wstawia określony tekst w przypadku danego przesunięcia znaku.

Parametry

NazwaTypOpis
offsetIntegerprzesunięcie znaków, które ma zostać wstawione
textStringtekst do wstawienia

Zwróć

Text – 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

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

isBold()

Pobiera ustawienie pogrubienia.

Zwróć

Boolean – tekst jest pogrubiony lub pusty, 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

isBold(offset)

Pobiera ustawienie pogrubienia z uwzględnieniem określonego przesunięcia znaków.

Parametry

NazwaTypOpis
offsetIntegerprzesunięcie znaków

Zwróć

Boolean – pogrubienie,

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

isItalic()

Powoduje pobranie ustawienia kursywy.

Zwróć

Boolean – określa, czy tekst jest zapisany kursywą czy ma 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

isItalic(offset)

Pobiera ustawienie kursywy z określonym przesunięciem znaków.

Parametry

NazwaTypOpis
offsetIntegerprzesunięcie znaków

Zwróć

Boolean – ustawienie kursywy

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

isStrikethrough()

Pobiera ustawienie przekreślenia.

Zwróć

Boolean – tekst jest przekreślony lub pusty, 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

isStrikethrough(offset)

Pobiera ustawienie przekreślenia z określonym przesunięciem znaku.

Parametry

NazwaTypOpis
offsetIntegerprzesunięcie znaków

Zwróć

Boolean – przekreślenie,

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

isUnderline()

Pobiera ustawienie podkreślenia.

Zwróć

Boolean – tekst jest podkreślony lub pusty, 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

isUnderline(offset)

Pobiera ustawienie podkreślenia z określonym przesunięciem znaku.

Parametry

NazwaTypOpis
offsetIntegerprzesunięcie znaków

Zwróć

Boolean – ustawienie podkreślenia;

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

Text – 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

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;

Autoryzacja

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

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

replaceText(searchPattern, replacement)

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

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

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

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

var body = DocumentApp.getActiveDocument().getBody();

// Clear the text surrounding "Apps Script", with or without text.
body.replaceText("^.*Apps ?Script.*$", "Apps Script");

Parametry

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

Zwróć

Element – bieżący element

Autoryzacja

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

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

setAttributes(startOffset, endOffsetInclusive, attributes)

Stosuje określone atrybuty do danego zakresu znaków.

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.

Parametry

NazwaTypOpis
startOffsetIntegerpoczątek przesunięcia zakresu tekstowego
endOffsetInclusiveIntegerkoniec przesunięcia zakresu tekstowego
attributesObjectatrybuty elementu

Zwróć

Text – bieżący element

Autoryzacja

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

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

setAttributes(attributes)

Ustawia atrybuty elementu.

Wskazany parametr musi być obiektem, w którym każda nazwa właściwości jest elementem w wyliczeniach DocumentApp.Attribute, a każda wartość właściwości to nowa wartość do zastosowania.

var body = DocumentApp.getActiveDocument().getBody();

// Define a custom paragraph style.
var style = {};
style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] =
    DocumentApp.HorizontalAlignment.RIGHT;
style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri';
style[DocumentApp.Attribute.FONT_SIZE] = 18;
style[DocumentApp.Attribute.BOLD] = true;

// Append a plain paragraph.
var par = body.appendParagraph('A paragraph with custom style.');

// Apply the custom style.
par.setAttributes(style);

Parametry

NazwaTypOpis
attributesObjectAtrybuty elementu.

Zwróć

Text – 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(startOffset, endOffsetInclusive, color)

Ustawia kolor tła określonego zakresu znaków.

Parametry

NazwaTypOpis
startOffsetIntegerpoczątek przesunięcia zakresu tekstowego
endOffsetInclusiveIntegerkoniec przesunięcia zakresu tekstowego
colorStringkolor tła w notacji CSS (np. '#ffffff');

Zwróć

Text – bieżący element

Autoryzacja

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

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

setBackgroundColor(color)

Ustawia kolor tła.

Parametry

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

Zwróć

Text – 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

setBold(bold)

Ustawia pogrubienie.

Parametry

NazwaTypOpis
boldBooleanpogrubienie

Zwróć

Text – 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

setBold(startOffset, endOffsetInclusive, bold)

Ustawia pogrubienie na potrzeby określonego zakresu znaków.

Parametry

NazwaTypOpis
startOffsetIntegerpoczątek przesunięcia zakresu tekstowego
endOffsetInclusiveIntegerkoniec przesunięcia zakresu tekstowego
boldBooleanpogrubienie

Zwróć

Text – 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

setFontFamily(startOffset, endOffsetInclusive, fontFamilyName)

Ustawia rodzinę czcionek w określonym zakresie znaków. Może to być dowolna czcionka w menu Czcionka w Dokumentach lub Czcionki Google. Wielkość liter ma znaczenie. Nierozpoznane nazwy czcionek będą renderowane jako przecinki. Metody getFontFamily(offset) i setFontFamily(fontFamilyName) używają teraz nazw ciągów tekstowych dla czcionek zamiast wyliczenia FontFamily. Mimo że ta wartość typu enum została wycofana, będzie nadal dostępna dla zgodności ze starszymi skryptami.

Parametry

NazwaTypOpis
startOffsetIntegerpoczątek przesunięcia zakresu tekstowego
endOffsetInclusiveIntegerkoniec przesunięcia zakresu tekstowego
fontFamilyNameStringnazwę rodziny czcionek z menu Czcionka w Dokumentach lub Google Fonts

Zwróć

Text – 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

setFontFamily(fontFamilyName)

Ustawia rodzinę czcionek. Może to być dowolna czcionka w menu Czcionka w Dokumentach lub Czcionki Google. Wielkość liter ma znaczenie. Nierozpoznane nazwy czcionek będą renderowane jako przecinki. Metody getFontFamily() i setFontFamily(fontFamilyName) używają teraz nazw ciągów znaków dla czcionek zamiast wyliczenia FontFamily. Mimo że ta wartość typu enum została wycofana, będzie nadal dostępna dla zgodności ze starszymi skryptami.

Parametry

NazwaTypOpis
fontFamilyNameStringnazwę rodziny czcionek z menu Czcionka w Dokumentach lub Google Fonts

Zwróć

Text – 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

setFontSize(startOffset, endOffsetInclusive, size)

Ustawia rozmiar czcionki w określonym zakresie znaków.

Parametry

NazwaTypOpis
startOffsetIntegerpoczątek przesunięcia zakresu tekstowego
endOffsetInclusiveIntegerkoniec przesunięcia zakresu tekstowego
sizeNumberrozmiar czcionki,

Zwróć

Text – 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

setFontSize(size)

Ustawia rozmiar czcionki.

Parametry

NazwaTypOpis
sizeNumberrozmiar czcionki,

Zwróć

Text – 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

setForegroundColor(startOffset, endOffsetInclusive, color)

Ustawia kolor pierwszego planu dla określonego zakresu znaków.

Parametry

NazwaTypOpis
startOffsetIntegerpoczątek przesunięcia zakresu tekstowego
endOffsetInclusiveIntegerkoniec przesunięcia zakresu tekstowego
colorStringkolor pierwszego planu w formacie notacji CSS (np. '#ffffff')

Zwróć

Text – 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

setForegroundColor(color)

Ustawia kolor pierwszego planu.

Parametry

NazwaTypOpis
colorStringkolor pierwszego planu w formacie notacji CSS (np. '#ffffff')

Zwróć

Text – 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

setItalic(italic)

Powoduje ustawienie kursywy.

Parametry

NazwaTypOpis
italicBooleanustawienie kursywy

Zwróć

Text – 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

setItalic(startOffset, endOffsetInclusive, italic)

Ustawia ustawienie kursywy dla określonego zakresu znaków.

Parametry

NazwaTypOpis
startOffsetIntegerpoczątek przesunięcia zakresu tekstowego
endOffsetInclusiveIntegerkoniec przesunięcia zakresu tekstowego
italicBooleanustawienie kursywy

Zwróć

Text – 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(startOffset, endOffsetInclusive, url)

Ustawia adres URL linku dla określonego zakresu znaków.

Parametry

NazwaTypOpis
startOffsetIntegerpoczątek przesunięcia zakresu tekstowego
endOffsetInclusiveIntegerkoniec przesunięcia zakresu tekstowego
urlStringadres URL linku

Zwróć

Text – bieżący element

Autoryzacja

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

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

setLinkUrl(url)

Ustawia URL linku.

Parametry

NazwaTypOpis
urlStringadres URL linku

Zwróć

Text – 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

setStrikethrough(strikethrough)

Ustawia przekreślenie.

Parametry

NazwaTypOpis
strikethroughBooleanustawienie przekreślenia

Zwróć

Text – 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

setStrikethrough(startOffset, endOffsetInclusive, strikethrough)

Ustawia przekreślenie dla określonego zakresu znaków.

Parametry

NazwaTypOpis
startOffsetIntegerpoczątek przesunięcia zakresu tekstowego
endOffsetInclusiveIntegerkoniec przesunięcia zakresu tekstowego
strikethroughBooleanustawienie przekreślenia

Zwróć

Text – 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ść tekstową.

Parametry

NazwaTypOpis
textStringnowa zawartość tekstowa

Zwróć

Text – 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(startOffset, endOffsetInclusive, textAlignment)

Ustawia wyrównanie tekstu w danym zakresie 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

NazwaTypOpis
startOffsetIntegerpoczątek przesunięcia zakresu znaków
endOffsetInclusiveIntegerkońcowe przesunięcie zakresu znaków (włącznie)
textAlignmentTextAlignmenttyp dopasowania tekstu, który ma zostać zastosowany

Zwróć

Text – bieżący element

Autoryzacja

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

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

setTextAlignment(textAlignment)

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

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

Parametry

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

Zwróć

Text – 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

setUnderline(underline)

Ustawia ustawienie podkreślenia.

Parametry

NazwaTypOpis
underlineBooleanpodkreślenie

Zwróć

Text – 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

setUnderline(startOffset, endOffsetInclusive, underline)

Ustawia podkreślenie określonego zakresu znaków.

Parametry

NazwaTypOpis
startOffsetIntegerpoczątek przesunięcia zakresu tekstowego
endOffsetInclusiveIntegerkoniec przesunięcia zakresu tekstowego
underlineBooleanpodkreślenie

Zwróć

Text – 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