Classe ColorScaleCriterion - de formato de cor (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. 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)

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

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. Aqui você pode encontrar os valores possíveis para XlConditionValueTypes.

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 =