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

Возвращает 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

Возвращает 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

Удаляет Link .

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

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

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

Text Style

set Background Color(color)

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

Параметры

Имя Тип Описание
color Color

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

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

Авторизация

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

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

set Background Color(hexColor)

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

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

Параметры

Имя Тип Описание
hex Color String

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

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

Авторизация

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

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

set Background Color Transparent()

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

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

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

Авторизация

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

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

set Bold(bold)

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

Изменение жирности текста обновляет толщину шрифта, используемого для отображения текста.

Параметры

Имя Тип Описание
bold Boolean

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

Text Style

Авторизация

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

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

set Font Family(fontFamily)

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

Параметры

Имя Тип Описание
font Family String

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

Text Style

Авторизация

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

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

set Font Family And Weight(fontFamily, fontWeight)

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

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

Параметры

Имя Тип Описание
font Family String
font Weight Integer

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

Text Style

Авторизация

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

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

set Font Size(fontSize)

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

Параметры

Имя Тип Описание
font Size Number

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

Text Style

Авторизация

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

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

set Foreground Color(foregroundColor)

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

Параметры

Имя Тип Описание
foreground Color Color

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

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

Авторизация

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

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

set Foreground Color(hexColor)

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

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

Параметры

Имя Тип Описание
hex Color String

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

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

Авторизация

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

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

set Italic(italic)

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

Параметры

Имя Тип Описание
italic Boolean

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

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

Авторизация

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

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

set Link Slide(slide)

Устанавливает 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(slide);

Параметры

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

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

Text Style

Авторизация

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

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

set Link Slide(slidePosition)

Устанавливает 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 textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

Параметры

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

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

Text Style

Авторизация

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

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

set Link Url(url)

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

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

Поскольку нельзя устанавливать связи по символам новой строки, символы новой строки в 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

Авторизация

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

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

set Small Caps(smallCaps)

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

Параметры

Имя Тип Описание
small Caps Boolean

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

Text Style

Авторизация

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

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

set Strikethrough(strikethrough)

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

Параметры

Имя Тип Описание
strikethrough Boolean

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

Text Style

Авторизация

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

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

set Underline(underline)

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

Параметры

Имя Тип Описание
underline Boolean

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

Text Style

Авторизация

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

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