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