Classe ColorScaleCriterion (Excel VBA)

A classe ColorScaleCriterion representa os critérios dos limites mínimos, médios e máximos de uma formatação condicional de formato de cor.

Set

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

Dim csc as ColorScaleCriterion
Set csc = ActiveCell.FormatConditions(1).ColorScaleCriteria(Index:=1)

Os procedimentos a seguir podem ser usados ​​para definir variáveis ​​do tipo ColorScaleCriterion: ColorScale.ColorScaleCriteria e ColorScaleCriteria.Item

For Each

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

Dim cscColorScaleCriteria As ColorScaleCriterion
For Each cscColorScaleCriteria In ActiveCell.FormatConditions(1).ColorScaleCriteria
	
Next cscColorScaleCriteria

ColorScaleCriteria.Count

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

O número de critérios é equivalente ao número de valores limite atribuído a uma escala de cores. Isso será dois ou três, dependendo se você usar uma escala de duas cores ou uma escala de três cores para a regra de formatação condicional.

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

ColorScaleCriteria.Item

Retorna um único objeto ColorScaleCriterion da coleção ColorScaleCriteria . 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 escala de cores. Os critérios são equivalentes ao valores limite atribuídos à escala de cores. 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 ColorScaleCriterion.

Dim cscItem As ColorScaleCriterion
Set cscItem = ActiveCell.FormatConditions(1).ColorScaleCriteria(Index:=1)

FormatColor

Retorna um objeto FormatColor , que especifica a cor atribuída ao limite de um formato condicional de escala de cores. Somente leitura.

Você pode definir a cor dos limites mínimo, intermediário ou máximo para qualquer cor personalizada usando a propriedade Color ou a propriedade ThemeColor do objeto FormatColor .

Dim fcrFormatColor As FormatColor
Set fcrFormatColor = ActiveCell.FormatConditions(1).ColorScaleCriteria(1).FormatColor

Index

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

Para uma regra de formatação condicional de escala de duas cores, essa propriedade retornará um valor de "1" para o limite mínimo e "2" para o limite máximo. No uso de uma regra de escala de três cores, os valores serão "1" para o limite mínimo, "2" para o médio e "3" para o máximo.

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

Type

Retorna uma das constantes da enumeração XlConditionValueTypes , que especifica como os valores de limite para um formato condicional de barra de dados ou de escala de cores são determinados. 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 do valor limite para uma barra de dados ou escala de cores pode ser um número, percentagem, fórmula ou percentil. Definir o tipo como percentil usará a função Percentil no Microsoft Excel para determinar o valor limite.

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

Value

Retorna ou define o valor limite mínimo, médio ou máximo de uma formatação condicional de escala de cores. 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).ColorScaleCriteria(1).Value =