Excel.ShapeFont class

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

bold: boolean;

属性值

注解

[ API 集：ExcelApi 1.9 ]

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

color: string;

属性值

注解

[ API 集：ExcelApi 1.9 ]

与 对象关联的请求上下文。 这会将加载项的进程连接到 Office 主机应用程序的进程。

context: RequestContext;

属性值

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

italic: boolean;

属性值

注解

[ API 集：ExcelApi 1.9 ]

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

name: string;

属性值

注解

[ API 集：ExcelApi 1.9 ]

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

size: number;

属性值

注解

[ API 集：ExcelApi 1.9 ]

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

strikethrough: boolean;

属性值

注解

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

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

subscript: boolean;

属性值

注解

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

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

superscript: boolean;

属性值

注解

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

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

tintAndShade: number;

属性值

注解

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

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

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

属性值

注解

[ API 集：ExcelApi 1.9 ]

将命令加入队列以加载对象的指定属性。 阅读属性前必须先调用 context.sync()。

load(options?: Excel.Interfaces.ShapeFontLoadOptions): Excel.ShapeFont;

参数

返回

将命令加入队列以加载对象的指定属性。 阅读属性前必须先调用 context.sync()。

load(propertyNames?: string | string[]): Excel.ShapeFont;

参数

返回

将命令加入队列以加载对象的指定属性。 阅读属性前必须先调用 context.sync()。

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): Excel.ShapeFont;

参数

返回

同时设置对象的多个属性。 可以传递具有相应属性的纯对象，也可以传递同一类型的另一个 API 对象。

set(properties: Interfaces.ShapeFontUpdateData, options?: OfficeExtension.UpdateOptions): void;

参数

返回

基于现有的已加载对象，同时对对象设置多个属性。

set(properties: Excel.ShapeFont): void;

参数

返回

重写 JavaScript toJSON() 方法，以便在将 API 对象传递给 JSON.stringify()时提供更有用的输出。 JSON.stringify (，依次调用toJSON传递给它的 对象的 方法。) 虽然原始Excel.ShapeFont对象是 API 对象，toJSON但该方法返回一个纯 JavaScript 对象， (类型为 Excel.Interfaces.ShapeFontData) ，其中包含从原始对象加载的任何子属性的浅表副本。

toJSON(): Excel.Interfaces.ShapeFontData;

返回