PowerPoint.Interfaces.ShapeFontData interface

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

Properties

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.

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.

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

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 ]

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 ]

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 ]