ExcelScript.IconSetConditionalFormat interface
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
get |
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. |
get |
Se |
get |
Se |
get |
Se estiver definido, apresenta a opção de conjunto de ícones para o formato condicional. |
set |
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. |
set |
Se |
set |
Se |
set |
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
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
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
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