Classe IconCriterion (Excel VBA)

A classe IconCriterion representa o critério de um ícone individual em um conjunto de ícones. O critério especifica o intervalo de valores e o tipo de limite associado ao ícone na regra de formatação condicional de um conjunto de ícones.

Set

Para usar uma variável de classe IconCriterion, ela primeiro precisa ser instanciada por exemplo

Dim icncrt as IconCriterion
Set icncrt = ActiveCell.FormatConditions(1).IconCriteria(Index:=1)

Os procedimentos a seguir podem ser usados ​​para definir variáveis ​​do tipo IconCriterion: IconSetCondition.IconCriteria e IconCriteria.Item

For Each

Aqui está um exemplo de processamento dos itens IconCriterion em uma coleção.

Dim icncrtIconCriteria As IconCriterion
For Each icncrtIconCriteria In ActiveCell.FormatConditions(1).IconCriteria
	
Next icncrtIconCriteria

IconCriteria.Count

Retorna um valor Long que especifica o número de critérios para uma regra de formatação condicional de conjunto de ícones. Somente leitura.

O número de critérios é equivalente ao número de valores limite atribuído a um conjunto de ícones.

Dim lngCount As Long
lngCount = ActiveCell.FormatConditions(1).IconCriteria.Count

IconCriteria.Item

Retorna um único objeto IconCriterion da coleção IconCriteria . Somente leitura.

O valor do parâmetro Index não pode ser maior que o número de critérios definidos para um formato condicional de conjunto de ícones. Os critérios são equivalentes aos valores limite atribuídos a um conjunto de ícones. Para localizar o número de valores de limite, use a propriedade Count .

Sintaxe : expression.Item (Index)

Index: O número de índice do objeto IconCriterion.

Dim icncrtItem As IconCriterion
Set icncrtItem = ActiveCell.FormatConditions(1).IconCriteria(Index:=1)

Icon

Retorna ou especifica o ícone de um critério em uma regra de formatação condicional de conjunto de ícones. Leitura/gravação.

Os valores possíveis são xlIcon0Bars - Medidor de Sinal sem Nenhuma Barra Cheia, xlIcon0FilledBoxes - Nenhuma Caixa Preenchida, xlIcon1Bar - Medidor de Sinal com Uma Barra Cheia, xlIcon1FilledBox - Uma Caixa Preenchida, xlIcon2Bars - Medidor de Sinal com Duas Barras Cheias, xlIcon2FilledBoxes - Duas Caixas Preenchidas, xlIcon3Bars - Medidor de Sinal com Três Barras Cheias, xlIcon3FilledBoxes - Três Caixas Preenchidas, xlIcon4Bars - Medidor de Sinal com Quatro Barras Cheias, xlIcon4FilledBoxes - Quatro Caixas Preenchidas, xlIconBlackCircle - Círculo Preto, xlIconBlackCircleWithBorder - Círculo Preto com Borda, xlIconCircleWithOneWhiteQuarter - Círculo com um Quarto Branco, xlIconCircleWithThreeWhiteQuarters - Círculo com Três Quartos Brancos, xlIconCircleWithTwoWhiteQuarters - Círculo com Dois Quartos Brancos, xlIconGoldStar - Estrela Dourada, xlIconGrayCircle - Círculo Cinza, xlIconGrayDownArrow - Seta para Baixo Cinza, xlIconGrayDownInclineArrow - Seta Inclinada para Baixo Cinza, xlIconGraySideArrow - Seta Lateral Cinza, xlIconGrayUpArrow - Seta para Cima Cinza, xlIconGrayUpInclineArrow - Seta Inclinada para Cima Cinza, xlIconGreenCheck - Marca Verde, xlIconGreenCheckSymbol - Símbolo de Marca Verde, xlIconGreenCircle - Círculo Verde, xlIconGreenFlag - Sinalizador Verde, xlIconGreenTrafficLight - Semáforo Verde, xlIconGreenUpArrow - Seta para Cima Verde, xlIconGreenUpTriangle - Triângulo Verde para Cima, xlIconHalfGoldStar - Meia Estrela Dourada, xlIconNoCellIcon - Sem Ícone de Célula, xlIconPinkCircle - Círculo Rosa, xlIconRedCircle - Círculo Vermelho, xlIconRedCircleWithBorder - Círculo Vermelho com Borda, xlIconRedCross - Cruz Vermelha, xlIconRedCrossSymbol - Símbolo de Cruz Vermelho, xlIconRedDiamond - Losango Vermelho, xlIconRedDownArrow - Seta para Baixo Vermelha, xlIconRedDownTriangle - Triângulo Vermelho para Baixo, xlIconRedFlag - Sinalizador Vermelho, xlIconRedTrafficLight - Semáforo Vermelho, xlIconSilverStar - Estrela Prateada, xlIconWhiteCircleAllWhiteQuarters - Círculo Branco (Todos os Quartos Brancos), xlIconYellowCircle - Círculo Amarelo, xlIconYellowDash - Barra Amarela, xlIconYellowDownInclineArrow - Seta Inclinada para Baixo Amarela, xlIconYellowExclamation - Exclamação Amarela, xlIconYellowExclamationSymbol - Ponto de Exclamação Amarelo, xlIconYellowFlag - Sinalizador Amarelo, xlIconYellowSideArrow - Seta Lateral Amarela, xlIconYellowTrafficLight - Semáforo Amarelo, xlIconYellowTriangle - Triângulo Amarelo, xlIconYellowUpInclineArrow - Seta Inclinada para Cima Amarela.

Depois de definir a propriedade Icon para o critério de ícone em uma regra de formatação condicional de conjunto de ícones, a propriedade Iconset do objeto IconSetCondition é alterada para xlCustomSet.

ActiveCell.FormatConditions(1).IconCriteria(1).Icon = xlIcon0Bars

Index

Retorna um valor Long indicando que limite os critérios representam. Somente leitura.

Para um conjunto de ícones, essa propriedade retornará um valor de 1 para o limite mínimo, 2 para o próximo limite e assim por diante.

Dim lngIndex As Long
lngIndex = ActiveCell.FormatConditions(1).IconCriteria(1).Index

Operator

Retorna ou define uma das constantes da enumeração XlFormatConditionOperator , que especifica se o limite é "maior que" ou "maior que ou igual a" o valor limite.

Para uma regra de formatação condicional de conjunto de ícones, essa propriedade pode ser definida somente como uma das duas seguintes constantes: xlGreater ou xlGreaterEqual.

ActiveCell.FormatConditions(1).IconCriteria(1).Operator =

Type

Retorna uma das constantes da enumeração XlConditionValueTypes , que especifica como o valor de limite para um conjunto de ícones é determinado. Somente leitura.

Os valores possíveis são xlConditionValueAutomaticMax - A barra de dados mais longa é proporcional ao valor máximo no intervalo, xlConditionValueAutomaticMin - A barra de dados mais curta é proporcional ao valor mínimo no intervalo, xlConditionValueFormula - Fórmula é usada, xlConditionValueHighestValue - O valor mais alto da lista de valores, xlConditionValueLowestValue - O valor mais baixo da lista de valores, xlConditionValueNone - Sem valor condicional, xlConditionValueNumber - Número é usado, xlConditionValuePercent - Porcentagem é usado, xlConditionValuePercentile - Percentil é usado.

O tipo de valor de limite para um conjunto de ícones pode ser um número, porcentagem, fórmula ou percentil. A definição do tipo como percentil usará a função percentil no Excel para determinar o valor do limite.

ActiveCell.FormatConditions(1).IconCriteria(1).Type = xlConditionValueAutomaticMax

Value

Retorna ou define o valor limite de um ícone em uma formatação condicional. de leitura/gravação.

Você só pode definir o valor se a propriedade Type para o formato condicional for definida como uma das seguintes constantes XlConditionValueTypes : xlConditionValueNumber, xlConditionValuePercent, ** xlConditionValuePercentile**ou xlConditionValueFormula. Se o tipo de limite for uma fórmula, você poderá definir a fórmula como um valor String. A fórmula deve retornar um único número.

ActiveCell.FormatConditions(1).IconCriteria(1).Value =