Стиль текста.
Методы чтения в этом классе возвращают значение 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
, если для текста используется несколько стилей.
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getBaselineOffset()
Возвращает смещение текста по вертикали от его нормального положения или значение null
, если для текста используется несколько стилей.
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
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
, если для текста используется несколько стилей.
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLink()
Возвращает Link
на текст или null
, если ссылки нет, или если ссылка находится в части текста, или если ссылок несколько. Вызовите hasLink()
, чтобы определить, нет ли в тексте ссылки.
var textLink = shape.getText().getTextStyle().getLink(); if (textLink != null) { Logger.log('Shape text has a link of type: ' + textLink.getLinkType()); }
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
hasLink()
Возвращает 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
removeLink()
setBackgroundColor(color)
setBackgroundColor(red, green, blue)
Устанавливает цвет фона текста в соответствии с заданными значениями RGB от 0 до 255.
Параметры
Имя | Тип | Описание |
---|---|---|
red | Integer | |
green | Integer | |
blue | Integer |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setBackgroundColor(hexColor)
Устанавливает цвет фона текста в заданную шестнадцатеричную цветовую строку.
Шестнадцатеричная строка должна быть в формате #RRGGBB. Например, розовый будет представлен как «#FFC0CB».
Параметры
Имя | Тип | Описание |
---|---|---|
hexColor | String |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setBackgroundColor(color)
Устанавливает цвет фона текста в заданный ThemeColorType
.
Параметры
Имя | Тип | Описание |
---|---|---|
color | ThemeColorType |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setBackgroundColorTransparent()
setBaselineOffset(offset)
Устанавливает вертикальное смещение текста относительно его нормального положения.
Параметры
Имя | Тип | Описание |
---|---|---|
offset | TextBaselineOffset |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setBold(bold)
Устанавливает, должен ли текст отображаться полужирным шрифтом.
Изменение жирности текста обновляет вес шрифта, используемый для отображения текста.
Параметры
Имя | Тип | Описание |
---|---|---|
bold | Boolean |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setFontFamily(fontFamily)
Устанавливает семейство шрифтов текста.
Параметры
Имя | Тип | Описание |
---|---|---|
fontFamily | String |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
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 |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setFontSize(fontSize)
Устанавливает размер шрифта текста в пунктах.
Параметры
Имя | Тип | Описание |
---|---|---|
fontSize | Number |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setForegroundColor(foregroundColor)
Устанавливает цвет переднего плана текста.
Параметры
Имя | Тип | Описание |
---|---|---|
foregroundColor | Color |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
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 |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setForegroundColor(hexColor)
Устанавливает цвет переднего плана текста в заданную шестнадцатеричную цветовую строку.
Шестнадцатеричная строка должна быть в формате #RRGGBB. Например, розовый будет представлен как «#FFC0CB».
Параметры
Имя | Тип | Описание |
---|---|---|
hexColor | String |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setForegroundColor(color)
Устанавливает цвет переднего плана текста в заданный ThemeColorType
.
Параметры
Имя | Тип | Описание |
---|---|---|
color | ThemeColorType |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setItalic(italic)
Устанавливает, выделяется ли текст курсивом.
Параметры
Имя | Тип | Описание |
---|---|---|
italic | Boolean |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
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 | Отсчитываемый от нуля индекс слайда. |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
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 , который нужно связать. |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
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 . |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
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. |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setSmallCaps(smallCaps)
Устанавливает, будет ли текст отображаться маленькими заглавными буквами.
Параметры
Имя | Тип | Описание |
---|---|---|
smallCaps | Boolean |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setStrikethrough(strikethrough)
Устанавливает, перечеркнут ли текст.
Параметры
Имя | Тип | Описание |
---|---|---|
strikethrough | Boolean |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setUnderline(underline)
Устанавливает, будет ли текст подчеркнут.
Параметры
Имя | Тип | Описание |
---|---|---|
underline | Boolean |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations