Compartir a través de


ExcelScript.RangeFont interface

Este objeto representa los atributos de fuente (nombre de fuente, tamaño de fuente, color, etc.) de un objeto.

Comentarios

Ejemplos

/**
 * This script sets the font of A1 to Arial, size 16.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get A1 on the current worksheet.
  const cell = workbook.getActiveWorksheet().getCell(0,0);

  // Adjust the font settings for that cell.
  const cellFont = cell.getFormat().getFont();
  cellFont.setName("Arial");
  cellFont.setSize(16);
}

Métodos

getBold()

Representa el estado en negrita de la fuente.

getColor()

Representación del código de color HTML del color de texto (por ejemplo, #FF0000 representa Rojo).

getItalic()

Especifica el estado en cursiva de la fuente.

getName()

Nombre de fuente (por ejemplo, "Calibri"). La longitud del nombre no debe tener más de 31 caracteres.

getSize()

Tamaño de fuente.

getStrikethrough()

Especifica el estado de tachado de la fuente. Un null valor indica que todo el intervalo no tiene una configuración uniforme de tachado.

getSubscript()

Especifica el estado del subíndice de la fuente. Devuelve true si todas las fuentes del intervalo son subíndices. Devuelve false si todas las fuentes del intervalo son superíndices o normales (ni superíndice ni subíndice). Devuelve null lo contrario.

getSuperscript()

Especifica el estado de superíndice de la fuente. Devuelve true si todas las fuentes del intervalo son superíndices. Devuelve false si todas las fuentes del intervalo son subíndices o normales (ni superíndice ni subíndice). Devuelve null lo contrario.

getTintAndShade()

Especifica un doble que aclara u oscurece un color para la fuente de rango. El valor está entre -1 (más oscuro) y 1 (más brillante), con 0 para el color original. Un null valor indica que todo el intervalo no tiene una configuración de fuente tintAndShade uniforme.

getUnderline()

Tipo de subrayado aplicado a la fuente. Vea ExcelScript.RangeUnderlineStyle para más información.

setBold(bold)

Representa el estado en negrita de la fuente.

setColor(color)

Representación del código de color HTML del color de texto (por ejemplo, #FF0000 representa Rojo).

setItalic(italic)

Especifica el estado en cursiva de la fuente.

setName(name)

Nombre de fuente (por ejemplo, "Calibri"). La longitud del nombre no debe tener más de 31 caracteres.

setSize(size)

Tamaño de fuente.

setStrikethrough(strikethrough)

Especifica el estado de tachado de la fuente. Un null valor indica que todo el intervalo no tiene una configuración uniforme de tachado.

setSubscript(subscript)

Especifica el estado del subíndice de la fuente. Devuelve true si todas las fuentes del intervalo son subíndices. Devuelve false si todas las fuentes del intervalo son superíndices o normales (ni superíndice ni subíndice). Devuelve null lo contrario.

setSuperscript(superscript)

Especifica el estado de superíndice de la fuente. Devuelve true si todas las fuentes del intervalo son superíndices. Devuelve false si todas las fuentes del intervalo son subíndices o normales (ni superíndice ni subíndice). Devuelve null lo contrario.

setTintAndShade(tintAndShade)

Especifica un doble que aclara u oscurece un color para la fuente de rango. El valor está entre -1 (más oscuro) y 1 (más brillante), con 0 para el color original. Un null valor indica que todo el intervalo no tiene una configuración de fuente tintAndShade uniforme.

setUnderline(underline)

Tipo de subrayado aplicado a la fuente. Vea ExcelScript.RangeUnderlineStyle para más información.

Detalles del método

getBold()

Representa el estado en negrita de la fuente.

getBold(): boolean;

Devoluciones

boolean

getColor()

Representación del código de color HTML del color de texto (por ejemplo, #FF0000 representa Rojo).

getColor(): string;

Devoluciones

string

getItalic()

Especifica el estado en cursiva de la fuente.

getItalic(): boolean;

Devoluciones

boolean

getName()

Nombre de fuente (por ejemplo, "Calibri"). La longitud del nombre no debe tener más de 31 caracteres.

getName(): string;

Devoluciones

string

getSize()

Tamaño de fuente.

getSize(): number;

Devoluciones

number

getStrikethrough()

Especifica el estado de tachado de la fuente. Un null valor indica que todo el intervalo no tiene una configuración uniforme de tachado.

getStrikethrough(): boolean;

Devoluciones

boolean

getSubscript()

Especifica el estado del subíndice de la fuente. Devuelve true si todas las fuentes del intervalo son subíndices. Devuelve false si todas las fuentes del intervalo son superíndices o normales (ni superíndice ni subíndice). Devuelve null lo contrario.

getSubscript(): boolean;

Devoluciones

boolean

getSuperscript()

Especifica el estado de superíndice de la fuente. Devuelve true si todas las fuentes del intervalo son superíndices. Devuelve false si todas las fuentes del intervalo son subíndices o normales (ni superíndice ni subíndice). Devuelve null lo contrario.

getSuperscript(): boolean;

Devoluciones

boolean

getTintAndShade()

Especifica un doble que aclara u oscurece un color para la fuente de rango. El valor está entre -1 (más oscuro) y 1 (más brillante), con 0 para el color original. Un null valor indica que todo el intervalo no tiene una configuración de fuente tintAndShade uniforme.

getTintAndShade(): number;

Devoluciones

number

getUnderline()

Tipo de subrayado aplicado a la fuente. Vea ExcelScript.RangeUnderlineStyle para más información.

getUnderline(): RangeUnderlineStyle;

Devoluciones

setBold(bold)

Representa el estado en negrita de la fuente.

setBold(bold: boolean): void;

Parámetros

bold

boolean

Devoluciones

void

Ejemplos

/**
 * This script bolds the text of cell A1.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get A1 on the current worksheet.
  const cell = workbook.getActiveWorksheet().getCell(0,0);

  // Bold the font for that cell
  cell.getFormat().getFont().setBold(true);
}

setColor(color)

Representación del código de color HTML del color de texto (por ejemplo, #FF0000 representa Rojo).

setColor(color: string): void;

Parámetros

color

string

Devoluciones

void

setItalic(italic)

Especifica el estado en cursiva de la fuente.

setItalic(italic: boolean): void;

Parámetros

italic

boolean

Devoluciones

void

setName(name)

Nombre de fuente (por ejemplo, "Calibri"). La longitud del nombre no debe tener más de 31 caracteres.

setName(name: string): void;

Parámetros

name

string

Devoluciones

void

Ejemplos

/**
 * This script sets the font style of A1 to Arial.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get A1 on the current worksheet.
  const cell = workbook.getActiveWorksheet().getCell(0,0);

  // Adjust the font settings for that cell.
  cell.getFormat().getFont().setName("Arial");
}

setSize(size)

Tamaño de fuente.

setSize(size: number): void;

Parámetros

size

number

Devoluciones

void

Ejemplos

/**
 * This script sets the font size of A1 to 16.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get A1 on the current worksheet.
  const cell = workbook.getActiveWorksheet().getCell(0,0);

  // Adjust the font settings for that cell.clear
  cell.getFormat().getFont().setSize(16);
}

setStrikethrough(strikethrough)

Especifica el estado de tachado de la fuente. Un null valor indica que todo el intervalo no tiene una configuración uniforme de tachado.

setStrikethrough(strikethrough: boolean): void;

Parámetros

strikethrough

boolean

Devoluciones

void

setSubscript(subscript)

Especifica el estado del subíndice de la fuente. Devuelve true si todas las fuentes del intervalo son subíndices. Devuelve false si todas las fuentes del intervalo son superíndices o normales (ni superíndice ni subíndice). Devuelve null lo contrario.

setSubscript(subscript: boolean): void;

Parámetros

subscript

boolean

Devoluciones

void

setSuperscript(superscript)

Especifica el estado de superíndice de la fuente. Devuelve true si todas las fuentes del intervalo son superíndices. Devuelve false si todas las fuentes del intervalo son subíndices o normales (ni superíndice ni subíndice). Devuelve null lo contrario.

setSuperscript(superscript: boolean): void;

Parámetros

superscript

boolean

Devoluciones

void

setTintAndShade(tintAndShade)

Especifica un doble que aclara u oscurece un color para la fuente de rango. El valor está entre -1 (más oscuro) y 1 (más brillante), con 0 para el color original. Un null valor indica que todo el intervalo no tiene una configuración de fuente tintAndShade uniforme.

setTintAndShade(tintAndShade: number): void;

Parámetros

tintAndShade

number

Devoluciones

void

setUnderline(underline)

Tipo de subrayado aplicado a la fuente. Vea ExcelScript.RangeUnderlineStyle para más información.

setUnderline(underline: RangeUnderlineStyle): void;

Parámetros

Devoluciones

void