Class TextStyle

文本的样式。

如果相应的 TextRange 跨越多个文本运行，并且这些运行对于所调用的读取方法具有不同的值，则此类中的读取方法会返回 null。为避免这种情况，请使用 TextRange.getRuns() 方法返回的 TextRange 查询文本样式。

如果您使用的方法会修改文字在形状中的排布方式，则应用于文字样式的任何自动调整设置都会停用。

方法

方法	返回类型	简介
`getBackgroundColor()`	`Color\|null`	返回文本的背景颜色，如果文本具有多种样式，则返回 `null`。
`getBaselineOffset()`	`TextBaselineOffset\|null`	返回文本相对于其正常位置的垂直偏移量；如果文本具有多种样式，则返回 `null`。
`getFontFamily()`	`String\|null`	返回文本的字体系列；如果文本具有多种样式，则返回 `null`。
`getFontSize()`	`Number\|null`	返回文本的字体大小（以磅为单位），如果文本具有多种样式，则返回 `null`。
`getFontWeight()`	`Integer\|null`	返回文本的字体粗细，如果文本具有多种样式，则返回 `null`。
`getForegroundColor()`	`Color\|null`	返回文本的前景色，如果文本具有多种样式，则返回 `null`。
`getLink()`	`Link\|null`	返回文本中的 `Link`，如果没有链接、链接位于部分文本中或有多重关联，则返回 `null`。
`hasLink()`	`Boolean\|null`	如果文本中存在链接，则返回 `true`；如果不存在链接，则返回 `false`；如果链接位于部分文本中或存在多个链接，则返回 `null`。
`isBackgroundTransparent()`	`Boolean\|null`	如果文本的背景是透明的，则返回 `true`；如果不是，则返回 `false`；如果文本具有多种样式，则返回 `null`。
`isBold()`	`Boolean\|null`	如果文本以粗体呈现，则返回 `true`；如果不是，则返回 `false`；如果文本具有多种样式，则返回 `null`。
`isItalic()`	`Boolean\|null`	如果文本为斜体，则返回 `true`；如果不是，则返回 `false`；如果文本具有多种样式，则返回 `null`。
`isSmallCaps()`	`Boolean\|null`	如果文本采用小型大写字母，则返回 `true`；否则返回 `false`；如果文本采用多种样式，则返回 `null`。
`isStrikethrough()`	`Boolean\|null`	如果文本带有删除线，则返回 `true`；如果文本不带删除线，则返回 `false`；如果文本具有多种样式，则返回 `null`。
`isUnderline()`	`Boolean\|null`	如果文本带有下划线，则返回 `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`，链接由给定的幻灯片 ID 设置。
`setLinkSlide(slidePosition)`	`TextStyle`	使用幻灯片的相对位置将 `Link` 设置为给定的 `Slide`。
`setLinkUrl(url)`	`TextStyle`	将 `Link` 设置为给定的非空网址字符串。
`setSmallCaps(smallCaps)`	`TextStyle`	设置文本是否以小型大写字母呈现。
`setStrikethrough(strikethrough)`	`TextStyle`	设置文本是否带有删除线。
`setUnderline(underline)`	`TextStyle`	设置文本是否带下划线。

详细文档

`getBackgroundColor()`

返回文本的背景颜色，如果文本具有多种样式，则返回 null。

Color|null - 文本的背景颜色。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`getBaselineOffset()`

返回文本相对于其正常位置的垂直偏移量；如果文本具有多种样式，则返回 null。

TextBaselineOffset|null - 文字相对于其正常位置的垂直偏移量。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`getFontFamily()`

返回文本的字体系列；如果文本具有多种样式，则返回 null。

String|null - 文本的字体系列。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`getFontSize()`

返回文本的字体大小（以磅为单位），如果文本具有多种样式，则返回 null。

Number|null - 文字的字体大小（以磅为单位）。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`getFontWeight()`

返回文本的字体粗细，如果文本具有多种样式，则返回 null。

权重是 100 到 900（含）之间的 100 的倍数。此范围对应于 CSS 2.1 规范第 15.6 节中描述的数值，不允许使用非数值。如果权重大于或等于 700，则视为粗体，在这种情况下，isBold() 会返回 true。默认值为 400（“正常”）。

Integer|null - 文本的字体粗细。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`getForegroundColor()`

返回文本的前景色，如果文本具有多种样式，则返回 null。

Color|null - 文本的前景色。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`getLink()`

返回文本中的 Link，如果没有链接、链接位于部分文本中或有多个链接，则返回 null。调用 hasLink() 以确定文本是否没有链接。

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

`hasLink()`

如果文本中存在链接，则返回 true；如果不存在，则返回 false；如果链接位于部分文本中或存在多个链接，则返回 null。

无法在换行符上设置链接。因此，如果 TextRange 包含换行符，此方法始终返回 null 或 false。

Boolean|null - 文本中是否有链接。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`isBackgroundTransparent()`

如果文本的背景是透明的，则返回 true；如果不是，则返回 false；如果文本具有多种样式，则返回 null。

Boolean|null - 文本的背景是否透明。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`isBold()`

如果文本以粗体呈现，则返回 true；如果不是，则返回 false；如果文本具有多种样式，则返回 null。

Boolean|null - 文本是否以粗体呈现。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`isItalic()`

如果文本为斜体，则返回 true；如果不是，则返回 false；如果文本具有多种样式，则返回 null。

Boolean|null - 文本是否为斜体。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`isSmallCaps()`

如果文本采用小型大写字母，则返回 true；否则返回 false；如果文本采用多种样式，则返回 null。

Boolean|null - 文本是否为小型大写字母。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`isStrikethrough()`

如果文本带有删除线，则返回 true；如果文本不带删除线，则返回 false；如果文本具有多种样式，则返回 null。

Boolean|null - 文本是否带有删除线。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`isUnderline()`

如果文本带有下划线，则返回 true；如果文本不带下划线，则返回 false；如果文本具有多种样式，则返回 null。

Boolean|null - 文本是否带下划线。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`removeLink()`

移除 Link。

移除链接会移除文本中的超链接前景色和下划线样式。如果可能，系统会应用这些样式，使链接与前面的文字保持一致。

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

TextStyle - 此 TextStyle，用于链式调用。

`setBackgroundColor(color)`

设置文字的背景颜色。

参数

名称	类型	说明
`color`	`Color`	要设置的背景颜色。

TextStyle - 此 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 - 此 TextStyle，用于链式调用。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`setBackgroundColor(hexColor)`

将文本的背景颜色设置为给定的十六进制颜色字符串。

十六进制字符串必须采用“#RRGGBB”格式。例如，粉色表示为

参数

名称	类型	说明
`hexColor`	`String`	十六进制颜色字符串。

TextStyle - 此 TextStyle，用于链式调用。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`setBackgroundColor(color)`

将文本的背景颜色设置为给定的 ThemeColorType。

参数

名称	类型	说明
`color`	`ThemeColorType`	主题颜色类型。

TextStyle - 此 TextStyle，用于链式调用。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`setBackgroundColorTransparent()`

将文本的背景颜色设置为透明。

TextStyle - 此 TextStyle，用于链式调用。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`setBaselineOffset(offset)`

设置文本相对于其正常位置的垂直偏移量。

参数

名称	类型	说明
`offset`	`TextBaselineOffset`	要设置的基准偏移量。

TextStyle - 此 TextStyle，用于链式调用。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`setBold(bold)`

设置文本是否应以粗体呈现。

参数

名称	类型	说明
`bold`	`Boolean`	是否将文本呈现为粗体。

TextStyle - 此 TextStyle，用于链式调用。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`setFontFamily(fontFamily)`

设置文本的字体系列。

参数

名称	类型	说明
`fontFamily`	`String`	要设置的字体系列。

TextStyle - 此 TextStyle，用于链式调用。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`setFontFamilyAndWeight(fontFamily, fontWeight)`

设置文本的字体系列和粗细。

参数

名称	类型	说明
`fontFamily`	`String`	字体系列。
`fontWeight`	`Integer`	字体粗细。

TextStyle - 此 TextStyle，用于链式调用。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`setFontSize(fontSize)`

设置文字的字体大小（以磅为单位）。

参数

名称	类型	说明
`fontSize`	`Number`	字体大小（以磅为单位）。

TextStyle - 此 TextStyle，用于链式调用。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`setForegroundColor(foregroundColor)`

设置文字的前景色。

参数

名称	类型	说明
`foregroundColor`	`Color`	要设置的前景颜色。

TextStyle - 此 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 - 此 TextStyle，用于链式调用。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`setForegroundColor(hexColor)`

将文本的前景颜色设置为给定的十六进制颜色字符串。

十六进制字符串必须采用“#RRGGBB”格式。例如，粉色表示为

参数

名称	类型	说明
`hexColor`	`String`	十六进制颜色字符串。

TextStyle - 此 TextStyle，用于链式调用。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`setForegroundColor(color)`

将文本的前景色设置为给定的 ThemeColorType。

参数

名称	类型	说明
`color`	`ThemeColorType`	主题颜色类型。

TextStyle - 此 TextStyle，用于链式调用。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`setItalic(italic)`

设置文本是否为斜体。

参数

名称	类型	说明
`italic`	`Boolean`	是否以斜体呈现文本。

TextStyle - 此 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.
const presentation = SlidesApp.getActivePresentation();
const slide = presentation.getSlides()[0];
const textRange = slide.getShapes()[0].getText();
textRange.getTextStyle().setLinkSlide(0);

参数

名称	类型	说明
`slideIndex`	`Integer`	幻灯片的索引（从零开始）。

TextStyle - 此 TextStyle，用于链式调用。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`setLinkSlide(slide)`

将 Link 设置为给定的 Slide，链接由给定的幻灯片 ID 设置。

设置链接会将文本的样式更改为加下划线并具有 ThemeColorType.HYPERLINK 前景色。您可以通过 setForegroundColor(hexColor) 和 setUnderline(underline) 更改此设置。

由于无法在换行符上设置链接，因此系统会忽略 TextRange 中的换行符。

// 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`。

TextStyle - 此 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.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

参数

名称	类型	说明
`slidePosition`	`SlidePosition`	相对 `SlidePosition`。

TextStyle - 此 TextStyle，用于链式调用。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`setLinkUrl(url)`

将 Link 设置为给定的非空网址字符串。

设置链接会将文本的样式更改为加下划线并具有 ThemeColorType.HYPERLINK 前景色。您可以通过 setForegroundColor(hexColor) 和 setUnderline(underline) 更改此设置。

由于无法在换行符上设置链接，因此系统会忽略 TextRange 中的换行符。

// Set a link to the URL.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().setLinkUrl('https://slides.google.com');

参数

名称	类型	说明
`url`	`String`	网址字符串。

TextStyle - 此 TextStyle，用于链式调用。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`setSmallCaps(smallCaps)`

设置文本是否以小型大写字母呈现。

参数

名称	类型	说明
`smallCaps`	`Boolean`	是否以小型大写字母渲染文本。

TextStyle - 此 TextStyle，用于链式调用。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`setStrikethrough(strikethrough)`

设置文本是否带有删除线。

参数

名称	类型	说明
`strikethrough`	`Boolean`	是否为文本添加删除线。

TextStyle - 此 TextStyle，用于链式调用。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`setUnderline(underline)`

设置文本是否带下划线。

参数

名称	类型	说明
`underline`	`Boolean`	是否为文字添加下划线。

TextStyle - 此 TextStyle，用于链式调用。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

Class TextStyle 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

方法

详细文档

getBackgroundColor()

返回

授权

getBaselineOffset()

返回

授权

getFontFamily()

返回

授权

getFontSize()

返回

授权

getFontWeight()

返回

授权

getForegroundColor()

返回

授权

getLink()

返回

授权

hasLink()

返回

授权

isBackgroundTransparent()

返回

授权

isBold()

返回

授权

isItalic()

返回

授权

isSmallCaps()

返回

授权

isStrikethrough()

返回

授权

isUnderline()

返回

授权

removeLink()

返回

setBackgroundColor(color)

参数

返回

授权

setBackgroundColor(red, green, blue)

参数

返回

授权

setBackgroundColor(hexColor)

参数

返回

授权

setBackgroundColor(color)

参数

返回

授权

setBackgroundColorTransparent()

返回

授权

setBaselineOffset(offset)

参数

返回

授权

setBold(bold)

参数

返回

授权

setFontFamily(fontFamily)

参数

返回

授权

setFontFamilyAndWeight(fontFamily, fontWeight)

参数

Class TextStyle

`getBackgroundColor()`

`getBaselineOffset()`

`getFontFamily()`

`getFontSize()`

`getFontWeight()`

`getForegroundColor()`

`getLink()`

`hasLink()`

`isBackgroundTransparent()`

`isBold()`

`isItalic()`

`isSmallCaps()`

`isStrikethrough()`

`isUnderline()`

`removeLink()`

`setBackgroundColor(color)`

`setBackgroundColor(red, green, blue)`

`setBackgroundColor(hexColor)`

`setBackgroundColor(color)`

`setBackgroundColorTransparent()`

`setBaselineOffset(offset)`

`setBold(bold)`

`setFontFamily(fontFamily)`

`setFontFamilyAndWeight(fontFamily, fontWeight)`

`setFontSize(fontSize)`

`setForegroundColor(foregroundColor)`

`setForegroundColor(red, green, blue)`

`setForegroundColor(hexColor)`

`setForegroundColor(color)`

`setItalic(italic)`

`setLinkSlide(slideIndex)`

`setLinkSlide(slide)`

`setLinkSlide(slidePosition)`

`setLinkUrl(url)`

`setSmallCaps(smallCaps)`

`setStrikethrough(strikethrough)`

`setUnderline(underline)`