Compartir a través de


ExcelScript.IconSetConditionalFormat interface

Representa un criterio de conjunto de iconos para el formato condicional.

Comentarios

Ejemplos

/**
 * This script applies icon set conditional formatting to a range.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the range "A1:A5" on the current worksheet.
  const sheet = workbook.getActiveWorksheet();
  const range = sheet.getRange("A1:A5");

  // Create icon set conditional formatting on the range.
  const conditionalFormatting = range.addConditionalFormat(ExcelScript.ConditionalFormatType.iconSet);
  const iconSetFormat: ExcelScript.IconSetConditionalFormat = conditionalFormatting.getIconSet();
  // Use the "3 Traffic Lights (Unrimmed)" set.
  iconSetFormat.setStyle(ExcelScript.IconSet.threeTrafficLights1);

  // Set the criteria to use a different icon for the bottom, middle, and top thirds of the values in the range.
  iconSetFormat.setCriteria([
    {
      formula:'=0',operator:ExcelScript.ConditionalIconCriterionOperator.greaterThanOrEqual,
      type:ExcelScript.ConditionalFormatIconRuleType.percent
    },
    {
      formula:'=33',operator:ExcelScript.ConditionalIconCriterionOperator.greaterThanOrEqual,
      type:ExcelScript.ConditionalFormatIconRuleType.percent},
    {
      formula:'=67',operator:ExcelScript.ConditionalIconCriterionOperator.greaterThanOrEqual,
      type:ExcelScript.ConditionalFormatIconRuleType.percent
    }]);
}

Métodos

getCriteria()

Matriz de criterios y conjuntos de iconos para las reglas y posibles iconos personalizados para iconos condicionales. Tenga en cuenta que para el primer criterio solo se puede modificar el icono personalizado, mientras que el tipo, la fórmula y el operador se omitirán cuando se establezca.

getReverseIconOrder()

Si truees , invierte los pedidos de icono para el conjunto de iconos. Tenga en cuenta que esto no se puede establecer si se usan iconos personalizados.

getShowIconOnly()

Si truees , oculta los valores y solo muestra iconos.

getStyle()

Si se establece, muestra la opción de conjunto de iconos para el formato condicional.

setCriteria(criteria)

Matriz de criterios y conjuntos de iconos para las reglas y posibles iconos personalizados para iconos condicionales. Tenga en cuenta que para el primer criterio solo se puede modificar el icono personalizado, mientras que el tipo, la fórmula y el operador se omitirán cuando se establezca.

setReverseIconOrder(reverseIconOrder)

Si truees , invierte los pedidos de icono para el conjunto de iconos. Tenga en cuenta que esto no se puede establecer si se usan iconos personalizados.

setShowIconOnly(showIconOnly)

Si truees , oculta los valores y solo muestra iconos.

setStyle(style)

Si se establece, muestra la opción de conjunto de iconos para el formato condicional.

Detalles del método

getCriteria()

Matriz de criterios y conjuntos de iconos para las reglas y posibles iconos personalizados para iconos condicionales. Tenga en cuenta que para el primer criterio solo se puede modificar el icono personalizado, mientras que el tipo, la fórmula y el operador se omitirán cuando se establezca.

getCriteria(): ConditionalIconCriterion[];

Devoluciones

getReverseIconOrder()

Si truees , invierte los pedidos de icono para el conjunto de iconos. Tenga en cuenta que esto no se puede establecer si se usan iconos personalizados.

getReverseIconOrder(): boolean;

Devoluciones

boolean

getShowIconOnly()

Si truees , oculta los valores y solo muestra iconos.

getShowIconOnly(): boolean;

Devoluciones

boolean

getStyle()

Si se establece, muestra la opción de conjunto de iconos para el formato condicional.

getStyle(): IconSet;

Devoluciones

setCriteria(criteria)

Matriz de criterios y conjuntos de iconos para las reglas y posibles iconos personalizados para iconos condicionales. Tenga en cuenta que para el primer criterio solo se puede modificar el icono personalizado, mientras que el tipo, la fórmula y el operador se omitirán cuando se establezca.

setCriteria(criteria: ConditionalIconCriterion[]): void;

Parámetros

Devoluciones

void

setReverseIconOrder(reverseIconOrder)

Si truees , invierte los pedidos de icono para el conjunto de iconos. Tenga en cuenta que esto no se puede establecer si se usan iconos personalizados.

setReverseIconOrder(reverseIconOrder: boolean): void;

Parámetros

reverseIconOrder

boolean

Devoluciones

void

setShowIconOnly(showIconOnly)

Si truees , oculta los valores y solo muestra iconos.

setShowIconOnly(showIconOnly: boolean): void;

Parámetros

showIconOnly

boolean

Devoluciones

void

setStyle(style)

Si se establece, muestra la opción de conjunto de iconos para el formato condicional.

setStyle(style: IconSet): void;

Parámetros

Devoluciones

void