Excel.Interfaces.ShapeFontLoadOptions interface

表示形状 TextRange 对象的字体属性,例如字体名称、字号和颜色。

注解

[ API 集:ExcelApi 1.9 ]

属性

$all

$all为加载选项指定将加载所有标量属性 ((例如Range.address) ,但不加载导航属性 (如 Range.format.fill.color) )。

bold

表示字体的加粗状态。 null如果 TextRange 同时包含加粗和非粗体文本片段,则返回 。

color

文本颜色 (的 HTML 颜色代码表示形式,例如,“#FF0000”表示红色) 。 null如果 TextRange 包含不同颜色的文本片段,则返回 。

italic

表示字体的斜体状态。 null如果 TextRange 同时包含斜体和非斜体文本片段,则返回 。

name

表示字体名称 (例如“Calibri”) 。 如果文本是复杂脚本或东亚语言,则这是相应的字体名称:否则为拉丁文字体名称。

size

以磅为单位表示字号 (,例如 11) 。 null如果 TextRange 包含具有不同字号的文本片段,则返回 。

strikethrough

指定字体的删除线状态。 值 null 指示整个范围没有统一删除线设置。

subscript

指定字体的下标状态。 true如果区域的所有字体均为下标,则返回 。 false如果区域的所有字体均为上标或普通 (既不是上标,也不是下标) ,则返回 。 否则返回 null

superscript

指定字体的上标状态。 true如果区域的所有字体均为上标,则返回 。 false如果区域的所有字体都是下标或普通 (既不是上标,也不是下标) ,则返回 。 否则返回 null

tintAndShade

指定使范围字体的颜色变浅或变暗的双精度值。 该值介于 -1 (最暗) 和 1 (最亮) 之间,原始颜色为 0。 值 null 指示整个区域没有统一的字体 tintAndShade 设置。

underline

应用于字体的下划线类型。 null如果 TextRange 包含具有不同下划线样式的文本片段,则返回 。 有关详细信息,请参阅 Excel.ShapeFontUnderlineStyle

属性详细信息

$all

$all为加载选项指定将加载所有标量属性 ((例如Range.address) ,但不加载导航属性 (如 Range.format.fill.color) )。

$all?: boolean;

属性值

boolean

bold

表示字体的加粗状态。 null如果 TextRange 同时包含加粗和非粗体文本片段,则返回 。

bold?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.9 ]

color

文本颜色 (的 HTML 颜色代码表示形式,例如,“#FF0000”表示红色) 。 null如果 TextRange 包含不同颜色的文本片段,则返回 。

color?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.9 ]

italic

表示字体的斜体状态。 null如果 TextRange 同时包含斜体和非斜体文本片段,则返回 。

italic?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.9 ]

name

表示字体名称 (例如“Calibri”) 。 如果文本是复杂脚本或东亚语言,则这是相应的字体名称:否则为拉丁文字体名称。

name?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.9 ]

size

以磅为单位表示字号 (,例如 11) 。 null如果 TextRange 包含具有不同字号的文本片段,则返回 。

size?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.9 ]

strikethrough

注意

此 API 以预览状态提供给开发者,可能根据我们收到的反馈更改。 请勿在生产环境中使用此 API。

指定字体的删除线状态。 值 null 指示整个范围没有统一删除线设置。

strikethrough?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi BETA (仅预览版) ]

subscript

注意

此 API 以预览状态提供给开发者,可能根据我们收到的反馈更改。 请勿在生产环境中使用此 API。

指定字体的下标状态。 true如果区域的所有字体均为下标,则返回 。 false如果区域的所有字体均为上标或普通 (既不是上标,也不是下标) ,则返回 。 否则返回 null

subscript?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi BETA (仅预览版) ]

superscript

注意

此 API 以预览状态提供给开发者,可能根据我们收到的反馈更改。 请勿在生产环境中使用此 API。

指定字体的上标状态。 true如果区域的所有字体均为上标,则返回 。 false如果区域的所有字体都是下标或普通 (既不是上标,也不是下标) ,则返回 。 否则返回 null

superscript?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi BETA (仅预览版) ]

tintAndShade

注意

此 API 以预览状态提供给开发者,可能根据我们收到的反馈更改。 请勿在生产环境中使用此 API。

指定使范围字体的颜色变浅或变暗的双精度值。 该值介于 -1 (最暗) 和 1 (最亮) 之间,原始颜色为 0。 值 null 指示整个区域没有统一的字体 tintAndShade 设置。

tintAndShade?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi BETA (仅预览版) ]

underline

应用于字体的下划线类型。 null如果 TextRange 包含具有不同下划线样式的文本片段,则返回 。 有关详细信息,请参阅 Excel.ShapeFontUnderlineStyle

underline?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.9 ]