ExcelScript.ShapeFont interface

Paquete:

ExcelScript

Representa los atributos de fuente, como el nombre de fuente, el tamaño de fuente y el color, para el objeto de TextRange una forma.

Comentarios

Ejemplos

/**
 * This sample sets the font of a shape to be bold. 
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the first shape in the current worksheet.
  const sheet = workbook.getActiveWorksheet();
  const shape = sheet.getShapes()[0];

  // Get the text font from the shape.
  const text: ExcelScript.TextRange = shape.getTextFrame().getTextRange();
  const shapeTextFont: ExcelScript.ShapeFont = text.getFont();

  // Set the font to be bold.
  shapeTextFont.setBold(true);
}

Métodos

getBold()	Representa el estado de negrita de la fuente. Devuelve null si TextRange incluye fragmentos de texto en negrita y no en negrita.
getColor()	Representación del código de color HTML del color de texto (por ejemplo, "#FF0000" representa rojo). Devuelve null si incluye TextRange fragmentos de texto con colores diferentes.
getItalic()	Indica el estado de cursiva de la fuente. Devuelve null si incluye TextRange fragmentos de texto cursiva y no cursiva.
getName()	Representa el nombre de fuente (por ejemplo, "Calibri"). Si el texto es un script complejo o un idioma asiático oriental, este es el nombre de fuente correspondiente; de lo contrario, es el nombre de la fuente latina.
getSize()	Representa el tamaño de fuente en puntos (por ejemplo, 11). Devuelve null si incluye TextRange fragmentos de texto con tamaños de fuente diferentes.
getUnderline()	Tipo de subrayado aplicado a la fuente. Devuelve null si incluye TextRange fragmentos de texto con estilos de subrayado diferentes. Vea ExcelScript.ShapeFontUnderlineStyle para más información.
setBold(bold)	Representa el estado de negrita de la fuente. Devuelve null si TextRange incluye fragmentos de texto en negrita y no en negrita.
setColor(color)	Representación del código de color HTML del color de texto (por ejemplo, "#FF0000" representa rojo). Devuelve null si incluye TextRange fragmentos de texto con colores diferentes.
setItalic(italic)	Indica el estado de cursiva de la fuente. Devuelve null si incluye TextRange fragmentos de texto cursiva y no cursiva.
setName(name)	Representa el nombre de fuente (por ejemplo, "Calibri"). Si el texto es un script complejo o un idioma asiático oriental, este es el nombre de fuente correspondiente; de lo contrario, es el nombre de la fuente latina.
setSize(size)	Representa el tamaño de fuente en puntos (por ejemplo, 11). Devuelve null si incluye TextRange fragmentos de texto con tamaños de fuente diferentes.
setUnderline(underline)	Tipo de subrayado aplicado a la fuente. Devuelve null si incluye TextRange fragmentos de texto con estilos de subrayado diferentes. Vea ExcelScript.ShapeFontUnderlineStyle para más información.

Detalles del método

getBold()

Representa el estado de negrita de la fuente. Devuelve null si TextRange incluye fragmentos de texto en negrita y no en negrita.

getBold(): boolean;

Devoluciones

boolean

getColor()

Representación del código de color HTML del color de texto (por ejemplo, "#FF0000" representa rojo). Devuelve null si incluye TextRange fragmentos de texto con colores diferentes.

getColor(): string;

Devoluciones

string

getItalic()

Indica el estado de cursiva de la fuente. Devuelve null si incluye TextRange fragmentos de texto cursiva y no cursiva.

getItalic(): boolean;

Devoluciones

boolean

getName()

Representa el nombre de fuente (por ejemplo, "Calibri"). Si el texto es un script complejo o un idioma asiático oriental, este es el nombre de fuente correspondiente; de lo contrario, es el nombre de la fuente latina.

getName(): string;

Devoluciones

string

getSize()

Representa el tamaño de fuente en puntos (por ejemplo, 11). Devuelve null si incluye TextRange fragmentos de texto con tamaños de fuente diferentes.

getSize(): number;

Devoluciones

number

getUnderline()

Tipo de subrayado aplicado a la fuente. Devuelve null si incluye TextRange fragmentos de texto con estilos de subrayado diferentes. Vea ExcelScript.ShapeFontUnderlineStyle para más información.

getUnderline(): ShapeFontUnderlineStyle;

Devoluciones

ExcelScript.ShapeFontUnderlineStyle

setBold(bold)

Representa el estado de negrita de la fuente. Devuelve null si TextRange incluye fragmentos de texto en negrita y no en negrita.

setBold(bold: boolean): void;

Parámetros

bold

boolean

Devoluciones

void

setColor(color)

Representación del código de color HTML del color de texto (por ejemplo, "#FF0000" representa rojo). Devuelve null si incluye TextRange fragmentos de texto con colores diferentes.

setColor(color: string): void;

Parámetros

color

string

Devoluciones

void

setItalic(italic)

Indica el estado de cursiva de la fuente. Devuelve null si incluye TextRange fragmentos de texto cursiva y no cursiva.

setItalic(italic: boolean): void;

Parámetros

italic

boolean

Devoluciones

void

setName(name)

Representa el nombre de fuente (por ejemplo, "Calibri"). Si el texto es un script complejo o un idioma asiático oriental, este es el nombre de fuente correspondiente; de lo contrario, es el nombre de la fuente latina.

setName(name: string): void;

Parámetros

name

string

Devoluciones

void

setSize(size)

Representa el tamaño de fuente en puntos (por ejemplo, 11). Devuelve null si incluye TextRange fragmentos de texto con tamaños de fuente diferentes.

setSize(size: number): void;

Parámetros

size

number

Devoluciones

void

setUnderline(underline)

Tipo de subrayado aplicado a la fuente. Devuelve null si incluye TextRange fragmentos de texto con estilos de subrayado diferentes. Vea ExcelScript.ShapeFontUnderlineStyle para más información.

setUnderline(underline: ShapeFontUnderlineStyle): void;

Parámetros

underline

ExcelScript.ShapeFontUnderlineStyle

Devoluciones

void