Edit

Share via

PowerPoint.Interfaces.ShapeFontData interface

  • Reference
Package:
powerpoint

An interface describing the data returned by calling shapeFont.toJSON().

Properties

allCaps

Specifies whether the text in the TextRange is set to use the All Caps attribute which makes lowercase letters appear as uppercase letters. The possible values are as follows:

  • true: All the text has the All Caps attribute.

  • false: None of the text has the All Capsattribute.

  • null: Some, but not all, of the text has the All Caps attribute.
bold

Specifies whether the text in the TextRange is set to bold. The possible values are as follows:

  • true: All the text is bold.

  • false: None of the text is bold.

  • null: Returned if some, but not all, of the text is bold.
color

Specifies the HTML color code representation of the text color (e.g., "#FF0000" represents red). Returns null if the TextRange contains text fragments with different colors.
doubleStrikethrough

Specifies whether the text in the TextRange is set to use the Double strikethrough attribute. The possible values are as follows:

  • true: All the text has the Double strikethrough attribute.

  • false: None of the text has the Double strikethrough attribute.

  • null: Returned if some, but not all, of the text has the Double strikethrough attribute.
italic

Specifies whether the text in the TextRange is set to italic. The possible values are as follows:

  • true: All the text is italicized.

  • false: None of the text is italicized.

  • null: Returned if some, but not all, of the text is italicized.
name

Specifies the font name (e.g., "Calibri"). If the text is a Complex Script or East Asian language, this is the corresponding font name; otherwise it is the Latin font name. Returns null if the TextRange contains text fragments with different font names.
size

Specifies the font size in points (e.g., 11). Returns null if the TextRange contains text fragments with different font sizes.
smallCaps

Specifies whether the text in the TextRange is set to use the Small Caps attribute which makes lowercase letters appear as small uppercase letters. The possible values are as follows:

  • true: All the text has the Small Caps attribute.

  • false: None of the text has the Small Caps attribute.

  • null: Returned if some, but not all, of the text has the Small Caps attribute.
strikethrough

Specifies whether the text in the TextRange is set to use the Strikethrough attribute. The possible values are as follows:

  • true: All the text has the Strikethrough attribute.

  • false: None of the text has the Strikethrough attribute.

  • null: Returned if some, but not all, of the text has the Strikethrough attribute.
subscript

Specifies whether the text in the TextRange is set to use the Subscript attribute. The possible values are as follows:

  • true: All the text has the Subscript attribute.

  • false: None of the text has the Subscript attribute.

  • null: Returned if some, but not all, of the text has the Subscript attribute.
superscript

Specifies whether the text in the TextRange is set to use the Superscript attribute. The possible values are as follows:

  • true: All the text has the Superscript attribute.

  • false: None of the text has the Superscript attribute.

  • null: Returned if some, but not all, of the text has the Superscript attribute.
underline

Specifies the type of underline applied to the font. Returns null if the TextRange contains text fragments with different underline styles. See PowerPoint.ShapeFontUnderlineStyle for details.

Property Details

allCaps

Note

This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.

Specifies whether the text in the TextRange is set to use the All Caps attribute which makes lowercase letters appear as uppercase letters. The possible values are as follows:

  • true: All the text has the All Caps attribute.

  • false: None of the text has the All Capsattribute.

  • null: Some, but not all, of the text has the All Caps attribute.

allCaps?: boolean | null;

Property Value

boolean | null

Remarks

[ API set: PowerPointApi BETA (PREVIEW ONLY) ]

bold

Specifies whether the text in the TextRange is set to bold. The possible values are as follows:

  • true: All the text is bold.

  • false: None of the text is bold.

  • null: Returned if some, but not all, of the text is bold.

bold?: boolean | null;

Property Value

boolean | null

Remarks

[ API set: PowerPointApi 1.4 ]

color

Specifies the HTML color code representation of the text color (e.g., "#FF0000" represents red). Returns null if the TextRange contains text fragments with different colors.

color?: string | null;

Property Value

string | null

Remarks

[ API set: PowerPointApi 1.4 ]

doubleStrikethrough

Note

This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.

Specifies whether the text in the TextRange is set to use the Double strikethrough attribute. The possible values are as follows:

  • true: All the text has the Double strikethrough attribute.

  • false: None of the text has the Double strikethrough attribute.

  • null: Returned if some, but not all, of the text has the Double strikethrough attribute.

doubleStrikethrough?: boolean | null;

Property Value

boolean | null

Remarks

[ API set: PowerPointApi BETA (PREVIEW ONLY) ]

italic

Specifies whether the text in the TextRange is set to italic. The possible values are as follows:

  • true: All the text is italicized.

  • false: None of the text is italicized.

  • null: Returned if some, but not all, of the text is italicized.

italic?: boolean | null;

Property Value

boolean | null

Remarks

[ API set: PowerPointApi 1.4 ]

name

Specifies the font name (e.g., "Calibri"). If the text is a Complex Script or East Asian language, this is the corresponding font name; otherwise it is the Latin font name. Returns null if the TextRange contains text fragments with different font names.

name?: string | null;

Property Value

string | null

Remarks

[ API set: PowerPointApi 1.4 ]

size

Specifies the font size in points (e.g., 11). Returns null if the TextRange contains text fragments with different font sizes.

size?: number | null;

Property Value

number | null

Remarks

[ API set: PowerPointApi 1.4 ]

smallCaps

Note

This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.

Specifies whether the text in the TextRange is set to use the Small Caps attribute which makes lowercase letters appear as small uppercase letters. The possible values are as follows:

  • true: All the text has the Small Caps attribute.

  • false: None of the text has the Small Caps attribute.

  • null: Returned if some, but not all, of the text has the Small Caps attribute.

smallCaps?: boolean | null;

Property Value

boolean | null

Remarks

[ API set: PowerPointApi BETA (PREVIEW ONLY) ]

strikethrough

Note

This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.

Specifies whether the text in the TextRange is set to use the Strikethrough attribute. The possible values are as follows:

  • true: All the text has the Strikethrough attribute.

  • false: None of the text has the Strikethrough attribute.

  • null: Returned if some, but not all, of the text has the Strikethrough attribute.

strikethrough?: boolean | null;

Property Value

boolean | null

Remarks

[ API set: PowerPointApi BETA (PREVIEW ONLY) ]

subscript

Note

This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.

Specifies whether the text in the TextRange is set to use the Subscript attribute. The possible values are as follows:

  • true: All the text has the Subscript attribute.

  • false: None of the text has the Subscript attribute.

  • null: Returned if some, but not all, of the text has the Subscript attribute.

subscript?: boolean | null;

Property Value

boolean | null

Remarks

[ API set: PowerPointApi BETA (PREVIEW ONLY) ]

superscript

Note

This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.

Specifies whether the text in the TextRange is set to use the Superscript attribute. The possible values are as follows:

  • true: All the text has the Superscript attribute.

  • false: None of the text has the Superscript attribute.

  • null: Returned if some, but not all, of the text has the Superscript attribute.

superscript?: boolean | null;

Property Value

boolean | null

Remarks

[ API set: PowerPointApi BETA (PREVIEW ONLY) ]

underline

Specifies the type of underline applied to the font. Returns null if the TextRange contains text fragments with different underline styles. See PowerPoint.ShapeFontUnderlineStyle for details.

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

Property Value

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

Remarks

[ API set: PowerPointApi 1.4 ]