Compartir a través de

ExcelScript.DataBarConditionalFormat interface

  • Referencia
Paquete:
ExcelScript

Representa un tipo de barra de datos condicional de Excel.

Comentarios

Ejemplos

/**
 * This script creates data bar conditional formatting on the selected range.
 * The scale of the data bar goes from 0 to 1000.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the selected range.
  const selected = workbook.getSelectedRange();
  
  // Create new conditional formatting on the range.
  const format = selected.addConditionalFormat(ExcelScript.ConditionalFormatType.dataBar);
  const dataBarFormat: ExcelScript.DataBarConditionalFormat = format.getDataBar();

  // Set the lower bound of the data bar formatting to be 0.
  const lowerBound: ExcelScript.ConditionalDataBarRule = {
    type: ExcelScript.ConditionalFormatRuleType.number,
    formula: "0"
  };
  dataBarFormat.setLowerBoundRule(lowerBound);

  // Set the upper bound of the data bar formatting to be 1000.
  const upperBound: ExcelScript.ConditionalDataBarRule = {
    type: ExcelScript.ConditionalFormatRuleType.number,
    formula: "1000"
  };
  dataBarFormat.setUpperBoundRule(upperBound);
}

Métodos

getAxisColor()

Código de color HTML que representa el color de la línea Axis, en el formato #RRGGBB (por ejemplo, "FFA500") o como un color HTML con nombre (por ejemplo, "naranja"). El valor es "" (una cadena vacía) si no hay ningún eje presente o establecido.
getAxisFormat()

Representación de cómo se determina el eje para una barra de datos de Excel.
getBarDirection()

Especifica la dirección en la que se debe basar el gráfico de la barra de datos.
getLowerBoundRule()

Regla para lo que constituye el límite inferior (y cómo calcularlo, si procede) para una barra de datos. El ConditionalDataBarRule objeto debe establecerse como un objeto JSON (use x.lowerBoundRule = {...} en lugar de x.lowerBoundRule.formula = ...).
getNegativeFormat()

Representación de todos los valores a la izquierda del eje en una barra de datos de Excel.
getPositiveFormat()

Representación de todos los valores a la derecha del eje en una barra de datos de Excel.
getShowDataBarOnly()

Si truees , oculta los valores de las celdas donde se aplica la barra de datos.
getUpperBoundRule()

Regla de lo que constituye el límite superior (y cómo calcularlo, si es aplicable) de una barra de datos. El ConditionalDataBarRule objeto debe establecerse como un objeto JSON (use x.upperBoundRule = {...} en lugar de x.upperBoundRule.formula = ...).
setAxisColor(axisColor)

Código de color HTML que representa el color de la línea Axis, en el formato #RRGGBB (por ejemplo, "FFA500") o como un color HTML con nombre (por ejemplo, "naranja"). El valor es "" (una cadena vacía) si no hay ningún eje presente o establecido.
setAxisFormat(axisFormat)

Representación de cómo se determina el eje para una barra de datos de Excel.
setBarDirection(barDirection)

Especifica la dirección en la que se debe basar el gráfico de la barra de datos.
setLowerBoundRule(lowerBoundRule)

Regla para lo que constituye el límite inferior (y cómo calcularlo, si procede) para una barra de datos. El ConditionalDataBarRule objeto debe establecerse como un objeto JSON (use x.lowerBoundRule = {...} en lugar de x.lowerBoundRule.formula = ...).
setShowDataBarOnly(showDataBarOnly)

Si truees , oculta los valores de las celdas donde se aplica la barra de datos.
setUpperBoundRule(upperBoundRule)

Regla de lo que constituye el límite superior (y cómo calcularlo, si es aplicable) de una barra de datos. El ConditionalDataBarRule objeto debe establecerse como un objeto JSON (use x.upperBoundRule = {...} en lugar de x.upperBoundRule.formula = ...).

Detalles del método

getAxisColor()

Código de color HTML que representa el color de la línea Axis, en el formato #RRGGBB (por ejemplo, "FFA500") o como un color HTML con nombre (por ejemplo, "naranja"). El valor es "" (una cadena vacía) si no hay ningún eje presente o establecido.

getAxisColor(): string;

Devoluciones

string

getAxisFormat()

Representación de cómo se determina el eje para una barra de datos de Excel.

getAxisFormat(): ConditionalDataBarAxisFormat;

Devoluciones

ExcelScript.ConditionalDataBarAxisFormat

getBarDirection()

Especifica la dirección en la que se debe basar el gráfico de la barra de datos.

getBarDirection(): ConditionalDataBarDirection;

Devoluciones

ExcelScript.ConditionalDataBarDirection

getLowerBoundRule()

Regla para lo que constituye el límite inferior (y cómo calcularlo, si procede) para una barra de datos. El ConditionalDataBarRule objeto debe establecerse como un objeto JSON (use x.lowerBoundRule = {...} en lugar de x.lowerBoundRule.formula = ...).

getLowerBoundRule(): ConditionalDataBarRule;

Devoluciones

ExcelScript.ConditionalDataBarRule

getNegativeFormat()

Representación de todos los valores a la izquierda del eje en una barra de datos de Excel.

getNegativeFormat(): ConditionalDataBarNegativeFormat;

Devoluciones

ExcelScript.ConditionalDataBarNegativeFormat

getPositiveFormat()

Representación de todos los valores a la derecha del eje en una barra de datos de Excel.

getPositiveFormat(): ConditionalDataBarPositiveFormat;

Devoluciones

ExcelScript.ConditionalDataBarPositiveFormat

getShowDataBarOnly()

Si truees , oculta los valores de las celdas donde se aplica la barra de datos.

getShowDataBarOnly(): boolean;

Devoluciones

boolean

getUpperBoundRule()

Regla de lo que constituye el límite superior (y cómo calcularlo, si es aplicable) de una barra de datos. El ConditionalDataBarRule objeto debe establecerse como un objeto JSON (use x.upperBoundRule = {...} en lugar de x.upperBoundRule.formula = ...).

getUpperBoundRule(): ConditionalDataBarRule;

Devoluciones

ExcelScript.ConditionalDataBarRule

setAxisColor(axisColor)

Código de color HTML que representa el color de la línea Axis, en el formato #RRGGBB (por ejemplo, "FFA500") o como un color HTML con nombre (por ejemplo, "naranja"). El valor es "" (una cadena vacía) si no hay ningún eje presente o establecido.

setAxisColor(axisColor: string): void;

Parámetros

axisColor

string

Devoluciones

void

setAxisFormat(axisFormat)

Representación de cómo se determina el eje para una barra de datos de Excel.

setAxisFormat(axisFormat: ConditionalDataBarAxisFormat): void;

Parámetros

axisFormat
ExcelScript.ConditionalDataBarAxisFormat

Devoluciones

void

setBarDirection(barDirection)

Especifica la dirección en la que se debe basar el gráfico de la barra de datos.

setBarDirection(barDirection: ConditionalDataBarDirection): void;

Parámetros

barDirection
ExcelScript.ConditionalDataBarDirection

Devoluciones

void

setLowerBoundRule(lowerBoundRule)

Regla para lo que constituye el límite inferior (y cómo calcularlo, si procede) para una barra de datos. El ConditionalDataBarRule objeto debe establecerse como un objeto JSON (use x.lowerBoundRule = {...} en lugar de x.lowerBoundRule.formula = ...).

setLowerBoundRule(lowerBoundRule: ConditionalDataBarRule): void;

Parámetros

lowerBoundRule
ExcelScript.ConditionalDataBarRule

Devoluciones

void

setShowDataBarOnly(showDataBarOnly)

Si truees , oculta los valores de las celdas donde se aplica la barra de datos.

setShowDataBarOnly(showDataBarOnly: boolean): void;

Parámetros

showDataBarOnly

boolean

Devoluciones

void

setUpperBoundRule(upperBoundRule)

Regla de lo que constituye el límite superior (y cómo calcularlo, si es aplicable) de una barra de datos. El ConditionalDataBarRule objeto debe establecerse como un objeto JSON (use x.upperBoundRule = {...} en lugar de x.upperBoundRule.formula = ...).

setUpperBoundRule(upperBoundRule: ConditionalDataBarRule): void;

Parámetros

upperBoundRule
ExcelScript.ConditionalDataBarRule

Devoluciones

void