ExcelScript.IconSetConditionalFormat interface

Pacote:

ExcelScript

Representa um critério de conjunto de ícones para formatação condicional.

Comentários

Exemplos

/**
 * 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()	Uma matriz de critérios e conjuntos de ícones para as regras e potenciais ícones personalizados para ícones condicionais. Tenha em atenção que, para o primeiro critério, apenas o ícone personalizado pode ser modificado, enquanto o tipo, fórmula e operador serão ignorados quando definido.
getReverseIconOrder()	Se true, inverter as encomendas de ícones do conjunto de ícones. Tenha em atenção que isto não pode ser definido se forem utilizados ícones personalizados.
getShowIconOnly()	Se true, oculta os valores e mostra apenas os ícones.
getStyle()	Se estiver definido, apresenta a opção de conjunto de ícones para o formato condicional.
setCriteria(criteria)	Uma matriz de critérios e conjuntos de ícones para as regras e potenciais ícones personalizados para ícones condicionais. Tenha em atenção que, para o primeiro critério, apenas o ícone personalizado pode ser modificado, enquanto o tipo, fórmula e operador serão ignorados quando definido.
setReverseIconOrder(reverseIconOrder)	Se true, inverter as encomendas de ícones do conjunto de ícones. Tenha em atenção que isto não pode ser definido se forem utilizados ícones personalizados.
setShowIconOnly(showIconOnly)	Se true, oculta os valores e mostra apenas os ícones.
setStyle(style)	Se estiver definido, apresenta a opção de conjunto de ícones para o formato condicional.

Detalhes do método

getCriteria()

Uma matriz de critérios e conjuntos de ícones para as regras e potenciais ícones personalizados para ícones condicionais. Tenha em atenção que, para o primeiro critério, apenas o ícone personalizado pode ser modificado, enquanto o tipo, fórmula e operador serão ignorados quando definido.

getCriteria(): ConditionalIconCriterion[];

Retornos

ExcelScript.ConditionalIconCriterion[]

getReverseIconOrder()

Se true, inverter as encomendas de ícones do conjunto de ícones. Tenha em atenção que isto não pode ser definido se forem utilizados ícones personalizados.

getReverseIconOrder(): boolean;

Retornos

boolean

getShowIconOnly()

Se true, oculta os valores e mostra apenas os ícones.

getShowIconOnly(): boolean;

Retornos

boolean

getStyle()

Se estiver definido, apresenta a opção de conjunto de ícones para o formato condicional.

getStyle(): IconSet;

Retornos

ExcelScript.IconSet

setCriteria(criteria)

Uma matriz de critérios e conjuntos de ícones para as regras e potenciais ícones personalizados para ícones condicionais. Tenha em atenção que, para o primeiro critério, apenas o ícone personalizado pode ser modificado, enquanto o tipo, fórmula e operador serão ignorados quando definido.

setCriteria(criteria: ConditionalIconCriterion[]): void;

Parâmetros

criteria

ExcelScript.ConditionalIconCriterion[]

Retornos

void

setReverseIconOrder(reverseIconOrder)

Se true, inverter as encomendas de ícones do conjunto de ícones. Tenha em atenção que isto não pode ser definido se forem utilizados ícones personalizados.

setReverseIconOrder(reverseIconOrder: boolean): void;

Parâmetros

reverseIconOrder

boolean

Retornos

void

setShowIconOnly(showIconOnly)

Se true, oculta os valores e mostra apenas os ícones.

setShowIconOnly(showIconOnly: boolean): void;

Parâmetros

showIconOnly

boolean

Retornos

void

setStyle(style)

Se estiver definido, apresenta a opção de conjunto de ícones para o formato condicional.

setStyle(style: IconSet): void;

Parâmetros

style

ExcelScript.IconSet

Retornos

void