Excel.Interfaces.ShapeFontUpdateData interface

用于更新对象上的 ShapeFont 数据的接口,用于 在 中使用 shapeFont.set({ ... })

属性

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

属性详细信息

bold

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

bold?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.9 ]

color

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

color?: string;

属性值

string

注解

[ API 集:ExcelApi 1.9 ]

italic

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

italic?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.9 ]

name

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

name?: string;

属性值

string

注解

[ API 集:ExcelApi 1.9 ]

size

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

size?: number;

属性值

number

注解

[ 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?: number;

属性值

number

注解

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

underline

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

underline?: Excel.ShapeFontUnderlineStyle | "None" | "Single" | "Double" | "Heavy" | "Dotted" | "DottedHeavy" | "Dash" | "DashHeavy" | "DashLong" | "DashLongHeavy" | "DotDash" | "DotDashHeavy" | "DotDotDash" | "DotDotDashHeavy" | "Wavy" | "WavyHeavy" | "WavyDouble";

属性值

Excel.ShapeFontUnderlineStyle | "None" | "Single" | "Double" | "Heavy" | "Dotted" | "DottedHeavy" | "Dash" | "DashHeavy" | "DashLong" | "DashLongHeavy" | "DotDash" | "DotDashHeavy" | "DotDotDash" | "DotDotDashHeavy" | "Wavy" | "WavyHeavy" | "WavyDouble"

注解

[ API 集:ExcelApi 1.9 ]