Ta strona została przetłumaczona przez Cloud Translation API.

Class Text

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 FontFamily. Ta tablica wycofywana jest wciąż dostępna, ale nadal będzie dostępna pod kątem zgodności ze starszymi skryptami.

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 FontFamily. Ta tablica wycofywana jest wciąż dostępna, ale nadal będzie dostępna pod kątem zgodności ze starszymi skryptami.

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

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 FontFamily. Ta tablica wycofywana jest wciąż dostępna, ale nadal będzie dostępna pod kątem zgodności ze starszymi skryptami.

// 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 FontFamily. Ta tablica wycofywana jest wciąż dostępna, ale nadal będzie dostępna pod kątem zgodności ze starszymi skryptami.

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