Class TextStyle

Стиль текста

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

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

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

Методы

Метод Тип возврата Краткое описание
get Background Color() Color Возвращает цвет фона текста или null , если в тексте имеется несколько стилей.
get Baseline Offset() Text Baseline Offset Возвращает вертикальное смещение текста от его нормального положения или null , если в тексте имеется несколько стилей.
get Font Family() String Возвращает семейство шрифтов текста или null , если в тексте имеется несколько стилей.
get Font Size() Number Возвращает размер шрифта текста в пунктах или null , если в тексте используется несколько стилей.
get Font Weight() Integer Возвращает толщину шрифта текста или null , если в тексте используется несколько стилей.
get Foreground Color() Color Возвращает цвет переднего плана текста или null , если в тексте имеется несколько стилей.
get Link() Link Возвращает Link на текст или null , если ссылка отсутствует, ссылка находится на части текста или имеется несколько ссылок.
has Link() Boolean Возвращает true , если в тексте есть ссылка, false , если нет, или null если ссылка находится на части текста или имеется несколько ссылок.
is Background Transparent() Boolean Возвращает true , если фон текста прозрачен, false в противном случае или null , если в тексте используется несколько стилей.
is Bold() Boolean Возвращает значение true если текст отображается жирным шрифтом, false в противном случае или null , если в тексте используется несколько стилей.
is Italic() Boolean Возвращает true , если текст выделен курсивом, false , если нет, или null , если в тексте имеется несколько стилей.
is Small Caps() Boolean Возвращает true , если текст написан маленькими заглавными буквами, false в противном случае или null , если в тексте используется несколько стилей.
is Strikethrough() Boolean Возвращает true , если текст зачеркнут, false , если нет, или null если в тексте имеется несколько стилей.
is Underline() Boolean Возвращает 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

Авторизация

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

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

get Baseline Offset()

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

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

Text Baseline Offset

Авторизация

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

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

get Font Family()

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

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

String

Авторизация

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

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

get Font Size()

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

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

Number

Авторизация

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

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

get Font Weight()

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

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

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

Integer

Авторизация

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

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

get Foreground Color()

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

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

Color

Авторизация

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

  • 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

Авторизация

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

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

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

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

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

Boolean

Авторизация

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

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

is Background Transparent()

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

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

Boolean

Авторизация

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

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

is Bold()

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

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

Boolean

Авторизация

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

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

is Italic()

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

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

Boolean

Авторизация

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

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

is Small Caps()

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

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

Boolean

Авторизация

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

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

is Strikethrough()

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

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

Boolean

Авторизация

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

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

is Underline()

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

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

Boolean

Авторизация

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

  • 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)

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

Вес кратен 100 от 100 до 900 включительно. Этот диапазон соответствует числовым значениям, описанным в спецификации CSS 2.1, раздел 15.6 , нечисловые значения запрещены. Веса, превышающие или равные 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 переднего плана 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 переднего плана 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 переднего плана 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 переднего плана 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