此页面由 Cloud Translation API 翻译。

Class TextStyle

单元格中文本的呈现样式。

文本样式可以具有对应的 RichTextValue。如果 RichTextValue 跨越多个文本行，并且这些文本行对于给定的文本样式读取方法具有不同的值，则该方法会返回 null。为避免这种情况，请使用 RichTextValue.getRuns() 方法返回的富文本值查询文本样式。

方法

方法	返回类型	简介
`copy()`	`TextStyleBuilder`	创建一个文本样式构建器，并使用此文本样式的值对其进行初始化。
`getFontFamily()`	`String`	获取文本的字体系列。
`getFontSize()`	`Integer`	获取文本的字体大小（以磅为单位）。
`getForegroundColorObject()`	`Color`	获取文本的字体颜色。
`isBold()`	`Boolean`	获取文本是否为粗体。
`isItalic()`	`Boolean`	获取单元格是否为斜体。
`isStrikethrough()`	`Boolean`	获取单元格是否带有删除线。
`isUnderline()`	`Boolean`	获取单元格是否带下划线。

已弃用的方法

方法	返回类型	简介
`getForegroundColor()`	`String`	获取文本的字体颜色。

详细文档

`copy()`

创建一个文本样式构建器，并使用此文本样式的值对其进行初始化。

TextStyleBuilder - 此文本样式的构建器。

`getFontFamily()`

获取文本的字体系列。如果未设置字体系列或相应的 RichTextValue 具有多个使用不同字体系列的运行，则返回 null。

String - 文本的字体系列（例如“Arial”）或 null。

`getFontSize()`

获取文本的字体大小（以磅为单位）。如果未设置字体大小，或者相应的 RichTextValue 具有字体大小不同的多个运行，则返回 null。

Integer - 文本的字体大小或 null。

`getForegroundColorObject()`

获取文本的字体颜色。如果未设置字体颜色，或者相应的 RichTextValue 具有多个具有不同字体颜色的运行，则返回 null。

Color - 文本的字体颜色或 null。

`isBold()`

获取文本是否为粗体。如果未设置粗体或相应的 RichTextValue 有多个运行作业且具有不同的粗体设置，则返回 null。

Boolean - 单元格是否为粗体，或 null。

`isItalic()`

获取单元格是否为斜体。如果未设置斜体或相应的 RichTextValue 具有多个具有不同斜体设置的运行，则返回 null。

Boolean - 单元格是否为斜体，或 null。

`isStrikethrough()`

获取单元格是否带有删除线。如果未设置删除线，或者相应的 RichTextValue 具有多个具有不同删除线设置的运行，则返回 null。

Boolean - 单元格是否带有删除线，或 null。

`isUnderline()`

获取单元格是否带下划线。如果未设置下划线或相应的 RichTextValue 具有多个具有不同下划线设置的运行，则返回 null。

Boolean - 单元格是否带下划线，或 null。

已弃用的方法

`getForegroundColor()`

已弃用。已替换为 getForegroundColorObject()

获取文本的字体颜色。如果未设置字体颜色，或者相应的 RichTextValue 具有多个具有不同字体颜色的运行，则返回 null。

String - 文本的字体颜色，以十六进制 CSS 值（例如“#ff0000”）或 null 的形式。