PowerPoint.Interfaces.ShapeFontLoadOptions interface

包:

powerpoint

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

注解

[ API 集：PowerPointApi 1.4 ]

属性

$all	$all为加载选项指定将加载所有标量属性 (（例如Range.address) ，但不加载导航属性 (如 Range.format.fill.color) ）。
allCaps	指定是否将 中的 TextRange 文本设置为使用使小写字母显示为大写字母 的 All Caps 属性。 可能值包括： true ：所有文本都具有 All Caps 属性。 false ：没有文本具有 All Caps属性。 null ：文本的某些（但不是全部）具有 All Caps 属性。
bold	指定 中的文本 TextRange 是否设置为粗体。 可能值包括： true ：所有文本都加粗。 false ：文本均不加粗。 null ：如果部分文本（但不是全部）为粗体，则返回 。
color	指定文本颜色 (的 HTML 颜色代码表示形式，例如，“#FF0000”表示红色) 。 null如果 TextRange 包含不同颜色的文本片段，则返回 。
doubleStrikethrough	指定 是否将 中的 TextRange 文本设置为使用 Double 删除线 属性。 可能值包括： true ：所有文本都具有 Double 删除线 属性。 false ：任何文本都没有 双删除线 属性。 null ：如果文本的某些（但不是全部）具有 Double 删除线 属性，则返回 。
italic	指定 中的文本 TextRange 是否设置为斜体。 可能值包括： true ：所有文本都斜体化。 false ：不对文本进行斜体化。 null ：如果文本的某些（但不是全部）被斜体化，则返回 。
name	指定字体名称 (例如“Calibri”) 。 如果文本是复杂脚本或东亚语言，则这是相应的字体名称：否则为拉丁文字体名称。 null如果 TextRange 包含具有不同字体名称的文本片段，则返回 。
size	指定字体大小（以磅为单位）， (例如 11) 。 null如果 TextRange 包含具有不同字号的文本片段，则返回 。
smallCaps	指定是否将 中的 TextRange 文本设置为使用 Small Caps 属性，该属性使小写字母显示为小写字母。 可能值包括： true ：所有文本都具有 Small Caps 属性。 false ：没有一个文本具有 Small Caps 属性。 null ：如果部分（但不是全部）文本具有 Small Caps 属性，则返回 。
strikethrough	指定 是否将 中的 TextRange 文本设置为使用 Strikethrough 属性。 可能值包括： true ：所有文本都具有 Strikethrough 属性。 false ：没有一个文本具有 Strikethrough 属性。 null ：如果文本的某些（但不是全部）具有 Strikethrough 属性，则返回 。
subscript	指定 是否将 中的 TextRange 文本设置为使用 Subscript 属性。 可能值包括： true ：所有文本都具有 Subscript 属性。 false ：文本中没有 下标 属性。 null ：如果文本的某些（但不是全部）具有 Subscript 属性，则返回 。
superscript	指定字体的上标状态。 null如果 TextRange 同时包含上标和非上标文本片段，则返回 。
underline	指定应用于字体的下划线类型。 null如果 TextRange 包含具有不同下划线样式的文本片段，则返回 。 有关详细信息 ，请参阅 PowerPoint.ShapeFontUnderlineStyle 。

属性详细信息

$all

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

$all?: boolean;

属性值

boolean

allCaps

注意

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

指定是否将 中的 TextRange 文本设置为使用使小写字母显示为大写字母 的 All Caps 属性。 可能值包括：

• true ：所有文本都具有 All Caps 属性。

• false ：没有文本具有 All Caps属性。

• null ：文本的某些（但不是全部）具有 All Caps 属性。

allCaps?: boolean;

属性值

boolean

注解

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

bold

指定 中的文本 TextRange 是否设置为粗体。 可能值包括：

• true ：所有文本都加粗。

• false ：文本均不加粗。

• null ：如果部分文本（但不是全部）为粗体，则返回 。

bold?: boolean;

属性值

boolean

注解

[ API 集：PowerPointApi 1.4 ]

color

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

color?: boolean;

属性值

boolean

注解

[ API 集：PowerPointApi 1.4 ]

doubleStrikethrough

注意

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

指定 是否将 中的 TextRange 文本设置为使用 Double 删除线 属性。 可能值包括：

• true ：所有文本都具有 Double 删除线 属性。

• false ：任何文本都没有 双删除线 属性。

• null ：如果文本的某些（但不是全部）具有 Double 删除线 属性，则返回 。

doubleStrikethrough?: boolean;

属性值

boolean

注解

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

italic

指定 中的文本 TextRange 是否设置为斜体。 可能值包括：

• true ：所有文本都斜体化。

• false ：不对文本进行斜体化。

• null ：如果文本的某些（但不是全部）被斜体化，则返回 。

italic?: boolean;

属性值

boolean

注解

[ API 集：PowerPointApi 1.4 ]

name

指定字体名称 (例如“Calibri”) 。 如果文本是复杂脚本或东亚语言，则这是相应的字体名称：否则为拉丁文字体名称。 null如果 TextRange 包含具有不同字体名称的文本片段，则返回 。

name?: boolean;

属性值

boolean

注解

[ API 集：PowerPointApi 1.4 ]

size

指定字体大小（以磅为单位）， (例如 11) 。 null如果 TextRange 包含具有不同字号的文本片段，则返回 。

size?: boolean;

属性值

boolean

注解

[ API 集：PowerPointApi 1.4 ]

smallCaps

注意

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

指定是否将 中的 TextRange 文本设置为使用 Small Caps 属性，该属性使小写字母显示为小写字母。 可能值包括：

• true ：所有文本都具有 Small Caps 属性。

• false ：没有一个文本具有 Small Caps 属性。

• null ：如果部分（但不是全部）文本具有 Small Caps 属性，则返回 。

smallCaps?: boolean;

属性值

boolean

注解

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

strikethrough

注意

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

指定 是否将 中的 TextRange 文本设置为使用 Strikethrough 属性。 可能值包括：

• true ：所有文本都具有 Strikethrough 属性。

• false ：没有一个文本具有 Strikethrough 属性。

• null ：如果文本的某些（但不是全部）具有 Strikethrough 属性，则返回 。

strikethrough?: boolean;

属性值

boolean

注解

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

subscript

注意

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

指定 是否将 中的 TextRange 文本设置为使用 Subscript 属性。 可能值包括：

• true ：所有文本都具有 Subscript 属性。

• false ：文本中没有 下标 属性。

• null ：如果文本的某些（但不是全部）具有 Subscript 属性，则返回 。

subscript?: boolean;

属性值

boolean

注解

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

superscript

注意

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

指定字体的上标状态。 null如果 TextRange 同时包含上标和非上标文本片段，则返回 。

superscript?: boolean;

属性值

boolean

注解

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

underline

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

underline?: boolean;

属性值

boolean

注解

[ API 集：PowerPointApi 1.4 ]