Class TextStyle

ТекстСтиль

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

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

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

Методы

Метод Тип возврата Краткое описание
getBackgroundColor() Color Возвращает цвет фона текста или null , если в тексте имеется несколько стилей.
getBaselineOffset() TextBaselineOffset Возвращает вертикальное смещение текста от его нормального положения или null , если в тексте имеется несколько стилей.
getFontFamily() String Возвращает семейство шрифтов текста или null , если в тексте имеется несколько стилей.
getFontSize() Number Возвращает размер шрифта текста в пунктах или null если в тексте используется несколько стилей.
getFontWeight() Integer Возвращает толщину шрифта текста или null , если в тексте используется несколько стилей.
getForegroundColor() Color Возвращает цвет переднего плана текста или null , если в тексте имеется несколько стилей.
getLink() Link Возвращает Link на текст или null , если ссылка отсутствует, ссылка находится на части текста или имеется несколько ссылок.
hasLink() Boolean Возвращает true , если в тексте есть ссылка, false , если нет, или null , если ссылка находится на части текста или имеется несколько ссылок.
isBackgroundTransparent() Boolean Возвращает true если фон текста прозрачен, false в противном случае или null , если в тексте используется несколько стилей.
isBold() Boolean Возвращает true , если текст отображается жирным шрифтом, false в противном случае или null , если в тексте присутствует несколько стилей.
isItalic() Boolean Возвращает true если текст выделен курсивом, false , если нет, или null , если в тексте имеется несколько стилей.
isSmallCaps() Boolean Возвращает true если текст написан маленькими заглавными буквами, false в противном случае или null , если текст содержит несколько стилей.
isStrikethrough() Boolean Возвращает true , если текст зачеркнут, false , если нет, или null , если в тексте имеется несколько стилей.
isUnderline() Boolean Возвращает true если текст подчеркнут, false , если нет, или null , если текст содержит несколько стилей.
removeLink() TextStyle Удаляет Link .
setBackgroundColor(color) TextStyle Устанавливает цвет фона текста.
setBackgroundColor(red, green, blue) TextStyle Устанавливает цвет фона текста в заданные значения RGB от 0 до 255.
setBackgroundColor(hexColor) TextStyle Устанавливает цвет фона текста в заданную шестнадцатеричную строку цвета.
setBackgroundColor(color) TextStyle Устанавливает цвет фона текста для заданного ThemeColorType .
setBackgroundColorTransparent() TextStyle Устанавливает прозрачный цвет фона текста.
setBaselineOffset(offset) TextStyle Устанавливает вертикальное смещение текста относительно его нормального положения.
setBold(bold) TextStyle Устанавливает, должен ли текст отображаться жирным шрифтом.
setFontFamily(fontFamily) TextStyle Устанавливает семейство шрифтов текста.
setFontFamilyAndWeight(fontFamily, fontWeight) TextStyle Устанавливает семейство шрифтов и толщину текста.
setFontSize(fontSize) TextStyle Устанавливает размер шрифта текста в пунктах.
setForegroundColor(foregroundColor) TextStyle Устанавливает цвет переднего плана текста.
setForegroundColor(red, green, blue) TextStyle Устанавливает цвет переднего плана текста в заданные значения RGB от 0 до 255.
setForegroundColor(hexColor) TextStyle Устанавливает цвет переднего плана текста в заданную шестнадцатеричную строку цвета.
setForegroundColor(color) TextStyle Устанавливает цвет переднего плана текста для заданного ThemeColorType .
setItalic(italic) TextStyle Устанавливает, будет ли текст выделен курсивом.
setLinkSlide(slideIndex) TextStyle Устанавливает Link на данный Slide используя индекс слайда, начинающийся с нуля.
setLinkSlide(slide) TextStyle Устанавливает Link на данный Slide , ссылка устанавливается по заданному идентификатору слайда.
setLinkSlide(slidePosition) TextStyle Устанавливает Link на данный Slide используя относительное положение слайда.
setLinkUrl(url) TextStyle Устанавливает Link на данную непустую строку URL.
setSmallCaps(smallCaps) TextStyle Определяет, отображается ли текст маленькими заглавными буквами.
setStrikethrough(strikethrough) TextStyle Устанавливает, будет ли текст зачеркнут.
setUnderline(underline) TextStyle Устанавливает, подчеркнут ли текст.

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

getBackgroundColor()

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

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

Color

Авторизация

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

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

getBaselineOffset()

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

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

TextBaselineOffset

Авторизация

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

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

getFontFamily()

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

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

String

Авторизация

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

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

getFontSize()

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

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

Number

Авторизация

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

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

getFontWeight()

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

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

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

Integer

Авторизация

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

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

getForegroundColor()

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

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

Color

Авторизация

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

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

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

var 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 , если ссылка находится на части текста или имеется несколько ссылок.

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

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

Boolean

Авторизация

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

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

isBackgroundTransparent()

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

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

Boolean

Авторизация

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

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

isBold()

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

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

Boolean

Авторизация

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

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

isItalic()

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

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

Boolean

Авторизация

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

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

isSmallCaps()

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

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

Boolean

Авторизация

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

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

isStrikethrough()

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

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

Boolean

Авторизация

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

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

isUnderline()

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

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

Boolean

Авторизация

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

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

Удаляет Link .

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

text.getTextStyle().removeLink();

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

TextStyle

setBackgroundColor(color)

Устанавливает цвет фона текста.

Параметры

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

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

TextStyle

Авторизация

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

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

setBackgroundColor(red, green, blue)

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

Параметры

Имя Тип Описание
red Integer
green Integer
blue Integer

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

TextStyle

Авторизация

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

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

setBackgroundColor(hexColor)

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

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

Параметры

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

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

TextStyle

Авторизация

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

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

setBackgroundColor(color)

Устанавливает цвет фона текста для заданного ThemeColorType .

Параметры

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

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

TextStyle

Авторизация

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

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

setBackgroundColorTransparent()

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

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

TextStyle

Авторизация

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

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

setBaselineOffset(offset)

Устанавливает вертикальное смещение текста относительно его нормального положения.

Параметры

Имя Тип Описание
offset TextBaselineOffset

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

TextStyle

Авторизация

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

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

setBold(bold)

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

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

Параметры

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

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

TextStyle

Авторизация

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

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

setFontFamily(fontFamily)

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

Параметры

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

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

TextStyle

Авторизация

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

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

setFontFamilyAndWeight(fontFamily, fontWeight)

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

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

Параметры

Имя Тип Описание
fontFamily String
fontWeight Integer

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

TextStyle

Авторизация

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

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

setFontSize(fontSize)

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

Параметры

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

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

TextStyle

Авторизация

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

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

setForegroundColor(foregroundColor)

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

Параметры

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

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

TextStyle

Авторизация

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

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

setForegroundColor(red, green, blue)

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

Параметры

Имя Тип Описание
red Integer
green Integer
blue Integer

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

TextStyle

Авторизация

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

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

setForegroundColor(hexColor)

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

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

Параметры

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

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

TextStyle

Авторизация

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

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

setForegroundColor(color)

Устанавливает цвет переднего плана текста для заданного ThemeColorType .

Параметры

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

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

TextStyle

Авторизация

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

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

setItalic(italic)

Устанавливает, будет ли текст выделен курсивом.

Параметры

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

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

TextStyle

Авторизация

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

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

setLinkSlide(slideIndex)

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

Установка ссылки изменяет стиль текста, который будет подчеркнут и будет иметь цвет переднего плана ThemeColorType.HYPERLINK . Это можно изменить с помощью setForegroundColor(hexColor) и setUnderline(underline) .

Поскольку ссылки не могут быть установлены для символов новой строки, символы новой строки в TextRange игнорируются. 

// Set a link to the first slide of the presentation.
text.getTextStyle().setLinkSlide(0);

Параметры

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

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

TextStyle

Авторизация

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

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

setLinkSlide(slide)

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

Установка ссылки изменяет стиль текста, который будет подчеркнут и будет иметь цвет переднего плана ThemeColorType.HYPERLINK . Это можно изменить с помощью setForegroundColor(hexColor) и setUnderline(underline) .

Поскольку ссылки не могут быть установлены для символов новой строки, символы новой строки в TextRange игнорируются. 

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
text.getTextStyle().setLinkSlide(slide);

Параметры

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

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

TextStyle

Авторизация

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

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

setLinkSlide(slidePosition)

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

Установка ссылки изменяет стиль текста, который будет подчеркнут и будет иметь цвет переднего плана ThemeColorType.HYPERLINK . Это можно изменить с помощью setForegroundColor(hexColor) и setUnderline(underline) .

Поскольку ссылки не могут быть установлены для символов новой строки, символы новой строки в TextRange игнорируются. 

// Set a link to the first slide of the presentation.
text.getTextStyle().setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

Параметры

Имя Тип Описание
slidePosition SlidePosition Относительное SlidePosition .

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

TextStyle

Авторизация

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

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

setLinkUrl(url)

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

Установка ссылки изменяет стиль текста, который будет подчеркнут и будет иметь цвет переднего плана ThemeColorType.HYPERLINK . Это можно изменить с помощью setForegroundColor(hexColor) и setUnderline(underline) .

Поскольку ссылки не могут быть установлены для символов новой строки, символы новой строки в TextRange игнорируются. 

// Set a link to the URL.
text.getTextStyle().setLinkUrl("https://slides.google.com");

Параметры

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

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

TextStyle

Авторизация

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

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

setSmallCaps(smallCaps)

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

Параметры

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

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

TextStyle

Авторизация

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

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

setStrikethrough(strikethrough)

Устанавливает, будет ли текст зачеркнут.

Параметры

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

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

TextStyle

Авторизация

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

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

setUnderline(underline)

Устанавливает, подчеркнут ли текст.

Параметры

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

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

TextStyle

Авторизация

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

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