Compartir a través de


ExcelScript.ConditionalRangeFormat interface

Objeto de formato que encapsula la fuente, el relleno, los bordes y otras propiedades del intervalo de formatos condicionales.

Comentarios

Ejemplos

/**
 * This script applies cell value conditional formatting to a range.
 * Any value less than 60 will have the cell's fill color changed and the font made italic.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the range to format.
  const selectedRange = workbook.getSelectedRange();

  // Add cell value conditional formatting.
  const cellValueConditionalFormatting =
    selectedRange.addConditionalFormat(ExcelScript.ConditionalFormatType.cellValue).getCellValue();

  // Create the condition, in this case when the cell value is less than 60.
  const rule: ExcelScript.ConditionalCellValueRule = {
    formula1: "60",
    operator: ExcelScript.ConditionalCellValueOperator.lessThan
  };
  cellValueConditionalFormatting.setRule(rule);

  // Set the format to apply when the condition is met.
  const format: ExcelScript.ConditionalRangeFormat = cellValueConditionalFormatting.getFormat();
  format.getFill().setColor("yellow");
  format.getFont().setItalic(true);
}

Métodos

getBorders()

Colección de objetos de borde que se aplican al intervalo de formato condicional general.

getConditionalRangeBorder(index)

Obtiene un objeto de borde mediante su nombre.

getConditionalRangeBorderBottom()

Obtiene el borde inferior.

getConditionalRangeBorderLeft()

Obtiene el borde izquierdo.

getConditionalRangeBorderRight()

Obtiene el borde derecho.

getConditionalRangeBorderTop()

Obtiene el borde superior.

getFill()

Devuelve el objeto de relleno definido en el intervalo de formato condicional general.

getFont()

Devuelve el objeto de fuente definido en el intervalo de formato condicional general.

getNumberFormat()

Representa el código de formato de número de Excel para el intervalo especificado. Se borra si null se pasa.

setNumberFormat(numberFormat)

Representa el código de formato de número de Excel para el intervalo especificado. Se borra si null se pasa.

Detalles del método

getBorders()

Colección de objetos de borde que se aplican al intervalo de formato condicional general.

getBorders(): ConditionalRangeBorder[];

Devoluciones

getConditionalRangeBorder(index)

Obtiene un objeto de borde mediante su nombre.

getConditionalRangeBorder(
            index: ConditionalRangeBorderIndex
        ): ConditionalRangeBorder;

Parámetros

index
ExcelScript.ConditionalRangeBorderIndex

Valor de índice del objeto de borde que va a recuperarse. Vea ExcelScript.ConditionalRangeBorderIndex para más información.

Devoluciones

getConditionalRangeBorderBottom()

Obtiene el borde inferior.

getConditionalRangeBorderBottom(): ConditionalRangeBorder;

Devoluciones

getConditionalRangeBorderLeft()

Obtiene el borde izquierdo.

getConditionalRangeBorderLeft(): ConditionalRangeBorder;

Devoluciones

getConditionalRangeBorderRight()

Obtiene el borde derecho.

getConditionalRangeBorderRight(): ConditionalRangeBorder;

Devoluciones

getConditionalRangeBorderTop()

Obtiene el borde superior.

getConditionalRangeBorderTop(): ConditionalRangeBorder;

Devoluciones

getFill()

Devuelve el objeto de relleno definido en el intervalo de formato condicional general.

getFill(): ConditionalRangeFill;

Devoluciones

getFont()

Devuelve el objeto de fuente definido en el intervalo de formato condicional general.

getFont(): ConditionalRangeFont;

Devoluciones

getNumberFormat()

Representa el código de formato de número de Excel para el intervalo especificado. Se borra si null se pasa.

getNumberFormat(): string;

Devoluciones

string

setNumberFormat(numberFormat)

Representa el código de formato de número de Excel para el intervalo especificado. Se borra si null se pasa.

setNumberFormat(numberFormat: string): void;

Parámetros

numberFormat

string

Devoluciones

void