Эта страница переведена с помощью Cloud Translation API.

Class TextStyle

Стиль текста.

Методы чтения в этом классе возвращают null если соответствующий Text Range охватывает несколько фрагментов текста, и эти фрагменты имеют разные значения для вызываемого метода чтения. Чтобы избежать этого, запрашивайте стили текста, используя Text Range , возвращаемые методом Text Range.getRuns() .

Если вы используете методы, изменяющие способ размещения текста внутри фигуры, любые настройки автоматической подгонки, примененные к стилям текста, будут деактивированы.

Методы

Метод	Тип возвращаемого значения	Краткое описание
`get Background Color()`	`Color \|null`	Возвращает цвет фона текста или `null` , если к тексту применено несколько стилей.
`get Baseline Offset()`	`Text Baseline Offset \|null`	Возвращает вертикальное смещение текста относительно его обычного положения или `null` , если текст имеет несколько стилей.
`get Font Family()`	`String\|null`	Возвращает семейство шрифтов текста или `null` , если для текста используется несколько стилей.
`get Font Size()`	`Number\|null`	Возвращает размер шрифта текста в пунктах или `null` , если для текста используется несколько стилей.
`get Font Weight()`	`Integer\|null`	Возвращает толщину шрифта текста или `null` , если для текста используется несколько стилей.
`get Foreground Color()`	`Color \|null`	Возвращает цвет переднего плана текста или `null` , если текст имеет несколько стилей.
`get Link()`	`Link \|null`	Возвращает `Link` расположенную в тексте, или `null` , если ссылки нет, если ссылка находится в части текста или если ссылок несколько.
`has Link()`	`Boolean\|null`	Возвращает `true` если в тексте есть ссылка, `false` , если нет, или `null` если ссылка находится в части текста или ссылок несколько.
`is Background Transparent()`	`Boolean\|null`	Возвращает `true` , если фон текста прозрачный, `false` в противном случае или `null` , если текст имеет несколько стилей.
`is Bold()`	`Boolean\|null`	Возвращает `true` , если текст отображается жирным шрифтом, `false` в противном случае или `null` если к тексту применено несколько стилей.
`is Italic()`	`Boolean\|null`	Возвращает `true` если текст выделен курсивом, `false` , если нет, или `null` если текст имеет несколько стилей.
`is Small Caps()`	`Boolean\|null`	Возвращает `true` , если текст написан строчными буквами, `false` в противном случае или `null` , если текст имеет несколько стилей.
`is Strikethrough()`	`Boolean\|null`	Возвращает `true` если текст зачеркнут, `false` , если нет, или `null` если текст имеет несколько стилей.
`is Underline()`	`Boolean\|null`	Возвращает `true` если текст подчеркнут, `false` , если нет, или `null` если к тексту применено несколько стилей.
`remove Link()`	`Text Style`	Удаляет `Link` .
`set Background Color(color)`	`Text Style`	Задает цвет фона текста.
`set Background Color(red, green, blue)`	`Text Style`	Устанавливает цвет фона текста в соответствии с заданными значениями RGB от 0 до 255.
`set Background Color(hexColor)`	`Text Style`	Устанавливает цвет фона текста в соответствии с заданной шестнадцатеричной строкой цвета.
`set Background Color(color)`	`Text Style`	Устанавливает цвет фона текста в соответствии с заданным `Theme Color Type` .
`set Background Color Transparent()`	`Text Style`	Устанавливает прозрачный цвет фона текста.
`set Baseline Offset(offset)`	`Text Style`	Задает вертикальное смещение текста относительно его обычного положения.
`set Bold(bold)`	`Text Style`	Определяет, следует ли отображать текст жирным шрифтом.
`set Font Family(fontFamily)`	`Text Style`	Задает семейство шрифтов текста.
`set Font Family And Weight(fontFamily, fontWeight)`	`Text Style`	Задает семейство шрифтов и толщину текста.
`set Font Size(fontSize)`	`Text Style`	Задает размер шрифта текста в пунктах.
`set Foreground Color(foregroundColor)`	`Text Style`	Задает цвет текста.
`set Foreground Color(red, green, blue)`	`Text Style`	Устанавливает цвет переднего плана текста в соответствии с заданными значениями RGB от 0 до 255.
`set Foreground Color(hexColor)`	`Text Style`	Устанавливает цвет переднего плана текста в соответствии с заданной шестнадцатеричной строкой цвета.
`set Foreground Color(color)`	`Text Style`	Устанавливает цвет текста в соответствии с заданным `Theme Color Type` .
`set Italic(italic)`	`Text Style`	Определяет, будет ли текст выделен курсивом.
`set Link Slide(slideIndex)`	`Text Style`	Устанавливает `Link` на указанный `Slide` , используя нулевой индекс слайда.
`set Link Slide(slide)`	`Text Style`	Устанавливает `Link` на указанный `Slide` ; ссылка задается по идентификатору слайда.
`set Link Slide(slidePosition)`	`Text Style`	Устанавливает `Link` на указанный `Slide` , используя относительное положение слайда.
`set Link Url(url)`	`Text Style`	Устанавливает `Link` на заданную непустую строку URL.
`set Small Caps(smallCaps)`	`Text Style`	Определяет, будет ли текст отображаться строчными прописными буквами.
`set Strikethrough(strikethrough)`	`Text Style`	Определяет, будет ли текст зачеркнут.
`set Underline(underline)`	`Text Style`	Определяет, будет ли текст подчеркнут.

Подробная документация

`get Background Color()`

Возвращает цвет фона текста или null , если к тексту применено несколько стилей.

Возвращаться

Color |null — Цвет фона текста.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`get Baseline Offset()`

Возвращает вертикальное смещение текста относительно его обычного положения или null , если текст имеет несколько стилей.

Возвращаться

Text Baseline Offset |null — Вертикальное смещение текста относительно его обычного положения.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`get Font Family()`

Возвращает семейство шрифтов текста или null , если для текста используется несколько стилей.

Возвращаться

String|null — Семейство шрифтов текста.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`get Font Size()`

Возвращает размер шрифта текста в пунктах или null , если для текста используется несколько стилей.

Возвращаться

Number|null — Размер шрифта текста в пунктах.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`get Font Weight()`

Возвращает толщину шрифта текста или null , если для текста используется несколько стилей.

Значение weight является кратным 100 и находится в диапазоне от 100 до 900 включительно. Этот диапазон соответствует числовым значениям, описанным в разделе 15.6 спецификации CSS 2.1, при этом нечисловые значения не допускаются. Значения weight больше или равные 700 считаются жирными, в этом случае is Bold() возвращает true . Значение по умолчанию — 400 ("обычный").

Возвращаться

Integer|null — Толщина шрифта текста.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`get Foreground Color()`

Возвращает цвет переднего плана текста или null , если текст имеет несколько стилей.

Возвращаться

Color |null — Цвет переднего плана текста.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`get Link()`

Возвращает Link на текст или null , если ссылки нет, если ссылка находится на части текста или если ссылок несколько. Вызов has Link() для определения, есть ли у текста ссылка.

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const textLink = shape.getText().getTextStyle().getLink();
if (textLink != null) {
  Logger.log(`Shape text has a link of type: ${textLink.getLinkType()}`);
}

Возвращаться

Link |null — Ссылка в тексте.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`has Link()`

Возвращает true если в тексте есть ссылка, false , если нет, или null если ссылка находится в части текста или ссылок несколько.

Связи нельзя устанавливать по символам новой строки. Поэтому, если Text Range содержит символ новой строки, этот метод всегда возвращает либо null , либо false .

Возвращаться

Boolean|null — Наличие ссылки в тексте.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`is Background Transparent()`

Возвращает true , если фон текста прозрачный, false в противном случае или null , если текст имеет несколько стилей.

Возвращаться

Boolean|null — Является ли фон текста прозрачным.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`is Bold()`

Возвращает true , если текст отображается жирным шрифтом, false в противном случае или null если к тексту применено несколько стилей.

Возвращаться

Boolean|null — Определяет, будет ли текст отображаться жирным шрифтом.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`is Italic()`

Возвращает true если текст выделен курсивом, false , если нет, или null если текст имеет несколько стилей.

Возвращаться

Boolean|null — Выделяет ли текст курсивом.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`is Small Caps()`

Возвращает true , если текст написан строчными буквами, false в противном случае или null , если текст имеет несколько стилей.

Возвращаться

Boolean|null — Указывает, написан ли текст строчными буквами.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`is Strikethrough()`

Возвращает true если текст зачеркнут, false , если нет, или null если текст имеет несколько стилей.

Возвращаться

Boolean|null — Зачеркивается ли текст.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`is Underline()`

Возвращает true если текст подчеркнут, false , если нет, или null если к тексту применено несколько стилей.

Возвращаться

Boolean|null — Подчёркнут ли текст.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`remove Link()`

Удаляет Link .

Удаление ссылки приводит к удалению основного цвета и стиля подчеркивания текста гиперссылки. По возможности эти стили применяются в соответствии с текстом, предшествующим ссылке.

const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().removeLink();

Возвращаться

Text Style — Этот Text Style предназначен для создания цепочек сообщений.

`set Background Color(color)`

Задает цвет фона текста.

Параметры

Имя	Тип	Описание
`color`	`Color`	Цвет фона для установки.

Возвращаться

Text Style — Этот Text Style предназначен для создания цепочек сообщений.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`set Background Color(red, green, blue)`

Устанавливает цвет фона текста в соответствии с заданными значениями RGB от 0 до 255.

Параметры

Имя	Тип	Описание
`red`	`Integer`	Красная составляющая цвета.
`green`	`Integer`	Зелёная составляющая цвета.
`blue`	`Integer`	Синяя составляющая цвета.

Возвращаться

Text Style — Этот Text Style предназначен для создания цепочек сообщений.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`set Background Color(hexColor)`

Устанавливает цвет фона текста в соответствии с заданной шестнадцатеричной строкой цвета.

Шестнадцатеричная строка должна быть в формате '#RRGGBB'. Например, розовый цвет представляется как

Параметры

Имя	Тип	Описание
`hex Color`	`String`	Шестнадцатеричная строка цветов.

Возвращаться

Text Style — Этот Text Style предназначен для создания цепочек сообщений.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`set Background Color(color)`

Устанавливает цвет фона текста в соответствии с заданным Theme Color Type .

Параметры

Имя	Тип	Описание
`color`	`Theme Color Type`	Тип цветовой темы.

Возвращаться

Text Style — Этот Text Style предназначен для создания цепочек сообщений.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`set Background Color Transparent()`

Устанавливает прозрачный цвет фона текста.

Возвращаться

Text Style — Этот Text Style предназначен для создания цепочек сообщений.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`set Baseline Offset(offset)`

Задает вертикальное смещение текста относительно его обычного положения.

Параметры

Имя	Тип	Описание
`offset`	`Text Baseline Offset`	Базовое смещение для установки.

Возвращаться

Text Style — Этот Text Style предназначен для создания цепочек сообщений.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`set Bold(bold)`

Определяет, следует ли отображать текст жирным шрифтом.

Параметры

Имя	Тип	Описание
`bold`	`Boolean`	Выделить ли текст жирным шрифтом.

Возвращаться

Text Style — Этот Text Style предназначен для создания цепочек сообщений.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`set Font Family(fontFamily)`

Задает семейство шрифтов текста.

Параметры

Имя	Тип	Описание
`font Family`	`String`	Семейство шрифтов для установки.

Возвращаться

Text Style — Этот Text Style предназначен для создания цепочек сообщений.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`set Font Family And Weight(fontFamily, fontWeight)`

Задает семейство шрифтов и толщину текста.

Параметры

Имя	Тип	Описание
`font Family`	`String`	Семейство шрифтов.
`font Weight`	`Integer`	Толщина шрифта.

Возвращаться

Text Style — Этот Text Style предназначен для создания цепочек сообщений.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`set Font Size(fontSize)`

Задает размер шрифта текста в пунктах.

Параметры

Имя	Тип	Описание
`font Size`	`Number`	Размер шрифта в пунктах.

Возвращаться

Text Style — Этот Text Style предназначен для создания цепочек сообщений.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`set Foreground Color(foregroundColor)`

Задает цвет текста.

Параметры

Имя	Тип	Описание
`foreground Color`	`Color`	Цвет переднего плана для установки.

Возвращаться

Text Style — Этот Text Style предназначен для создания цепочек сообщений.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`set Foreground Color(red, green, blue)`

Устанавливает цвет переднего плана текста в соответствии с заданными значениями RGB от 0 до 255.

Параметры

Имя	Тип	Описание
`red`	`Integer`	Красная составляющая цвета.
`green`	`Integer`	Зелёная составляющая цвета.
`blue`	`Integer`	Синяя составляющая цвета.

Возвращаться

Text Style — Этот Text Style предназначен для создания цепочек сообщений.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`set Foreground Color(hexColor)`

Устанавливает цвет переднего плана текста в соответствии с заданной шестнадцатеричной строкой цвета.

Шестнадцатеричная строка должна быть в формате '#RRGGBB'. Например, розовый цвет представляется как

Параметры

Имя	Тип	Описание
`hex Color`	`String`	Шестнадцатеричная строка цветов.

Возвращаться

Text Style — Этот Text Style предназначен для создания цепочек сообщений.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`set Foreground Color(color)`

Устанавливает цвет текста в соответствии с заданным Theme Color Type .

Параметры

Имя	Тип	Описание
`color`	`Theme Color Type`	Тип цветовой темы.

Возвращаться

Text Style — Этот Text Style предназначен для создания цепочек сообщений.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`set Italic(italic)`

Определяет, будет ли текст выделен курсивом.

Параметры

Имя	Тип	Описание
`italic`	`Boolean`	Выделять ли текст курсивом.

Возвращаться

Text Style — Этот Text Style предназначен для создания цепочек сообщений.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`set Link Slide(slideIndex)`

Устанавливает Link на указанный Slide , используя нулевой индекс слайда.

Изменение стиля ссылки приводит к тому, что текст становится подчеркнутым и приобретает цвет переднего плана, заданный в соответствии с Theme Color Type.HYPERLINK . Это можно изменить с помощью set Foreground Color(hexColor) и set Underline(underline) .

Поскольку нельзя устанавливать связи по символам новой строки, символы новой строки в Text Range игнорируются.

// Set a link to the first slide of the presentation.
const presentation = SlidesApp.getActivePresentation();
const slide = presentation.getSlides()[0];
const textRange = slide.getShapes()[0].getText();
textRange.getTextStyle().setLinkSlide(0);

Параметры

Имя	Тип	Описание
`slide Index`	`Integer`	Индекс слайда, начинающийся с нуля.

Возвращаться

Text Style — Этот Text Style предназначен для создания цепочек сообщений.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`set Link Slide(slide)`

Устанавливает Link на указанный Slide ; ссылка задается по идентификатору слайда.

Поскольку нельзя устанавливать связи по символам новой строки, символы новой строки в Text Range игнорируются.

// Set a link to the first slide of the presentation.
const presentation = SlidesApp.getActivePresentation();
const slide = presentation.getSlides()[0];
const textRange = slide.getShapes()[0].getText();
textRange.getTextStyle().setLinkSlide(slide);

Параметры

Имя	Тип	Описание
`slide`	`Slide`	`Slide` , на который нужно сделать ссылку.

Возвращаться

Text Style — Этот Text Style предназначен для создания цепочек сообщений.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`set Link Slide(slidePosition)`

Устанавливает Link на указанный Slide , используя относительное положение слайда.

Поскольку нельзя устанавливать связи по символам новой строки, символы новой строки в Text Range игнорируются.

// Set a link to the first slide of the presentation.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

Параметры

Имя	Тип	Описание
`slide Position`	`Slide Position`	Относительное `Slide Position` .

Возвращаться

Text Style — Этот Text Style предназначен для создания цепочек сообщений.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`set Link Url(url)`

Устанавливает Link на заданную непустую строку URL.

Поскольку нельзя устанавливать связи по символам новой строки, символы новой строки в Text Range игнорируются.

// Set a link to the URL.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().setLinkUrl('https://slides.google.com');

Параметры

Имя	Тип	Описание
`url`	`String`	URL-строка.

Возвращаться

Text Style — Этот Text Style предназначен для создания цепочек сообщений.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`set Small Caps(smallCaps)`

Определяет, будет ли текст отображаться строчными прописными буквами.

Параметры

Имя	Тип	Описание
`small Caps`	`Boolean`	Следует ли писать текст строчными буквами.

Возвращаться

Text Style — Этот Text Style предназначен для создания цепочек сообщений.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`set Strikethrough(strikethrough)`

Определяет, будет ли текст зачеркнут.

Параметры

Имя	Тип	Описание
`strikethrough`	`Boolean`	Зачеркнуть ли текст.

Возвращаться

Text Style — Этот Text Style предназначен для создания цепочек сообщений.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`set Underline(underline)`

Определяет, будет ли текст подчеркнут.

Параметры

Имя	Тип	Описание
`underline`	`Boolean`	Подчеркивать ли текст.

Возвращаться

Text Style — Этот Text Style предназначен для создания цепочек сообщений.

Авторизация

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

Class TextStyle Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Методы

Подробная документация

get Background Color()

Возвращаться

Авторизация

get Baseline Offset()

Возвращаться

Авторизация

get Font Family()

Возвращаться

Авторизация

get Font Size()

Возвращаться

Авторизация

get Font Weight()

Возвращаться

Авторизация

get Foreground Color()

Возвращаться

Авторизация

get Link()

Возвращаться

Авторизация

has Link()

Возвращаться

Авторизация

is Background Transparent()

Возвращаться

Авторизация

is Bold()

Возвращаться

Авторизация

is Italic()

Возвращаться

Авторизация

is Small Caps()

Возвращаться

Авторизация

is Strikethrough()

Возвращаться

Авторизация

is Underline()

Возвращаться

Авторизация

remove Link()

Возвращаться

set Background Color(color)

Параметры

Возвращаться

Авторизация

set Background Color(red, green, blue)

Параметры

Возвращаться

Авторизация

set Background Color(hexColor)

Параметры

Возвращаться

Авторизация

set Background Color(color)

Параметры

Возвращаться

Авторизация

set Background Color Transparent()

Возвращаться

Авторизация

set Baseline Offset(offset)

Параметры

Возвращаться

Авторизация

set Bold(bold)

Параметры

Возвращаться

Авторизация

set Font Family(fontFamily)

Параметры

Возвращаться

Авторизация

set Font Family And Weight(fontFamily, fontWeight)

Параметры

Class TextStyle

`get Background Color()`

`get Baseline Offset()`

`get Font Family()`

`get Font Size()`

`get Font Weight()`

`get Foreground Color()`

`get Link()`

`has Link()`

`is Background Transparent()`

`is Bold()`

`is Italic()`

`is Small Caps()`

`is Strikethrough()`

`is Underline()`

`remove Link()`

`set Background Color(color)`

`set Background Color(red, green, blue)`

`set Background Color(hexColor)`

`set Background Color(color)`

`set Background Color Transparent()`

`set Baseline Offset(offset)`

`set Bold(bold)`

`set Font Family(fontFamily)`

`set Font Family And Weight(fontFamily, fontWeight)`

`set Font Size(fontSize)`

`set Foreground Color(foregroundColor)`

`set Foreground Color(red, green, blue)`

`set Foreground Color(hexColor)`

`set Foreground Color(color)`

`set Italic(italic)`

`set Link Slide(slideIndex)`

`set Link Slide(slide)`

`set Link Slide(slidePosition)`

`set Link Url(url)`

`set Small Caps(smallCaps)`

`set Strikethrough(strikethrough)`

`set Underline(underline)`