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 的形式。