Clase ColorScale (Excel VBA)

La clase ColorScale representa una regla de formato condicional de escala de colores.

Los principales procedimientos de la clase ColorScale son Delete, FormatConditions.Add, FormatConditions.AddAboveAverage, FormatConditions.AddColorScale, FormatConditions.AddDatabar, FormatConditions.AddIconSetCondition, FormatConditions.AddTop10, FormatConditions.AddUniqueValues y FormatConditions.Delete

Set

Para usar una variable de clase ColorScale, primero debe ser instanciado, por ejemplo

Dim cse as ColorScale
Set cse = ActiveCell.FormatConditions(Index:=1)

Los siguientes procedimientos se pueden usar para establecer variables de clase ColorScale : FormatConditions.AddColorScale, FormatConditions.AddColorScale, FormatConditions.AddColorScale, FormatConditions.AddColorScale, FormatConditions.AddColorScale, FormatConditions.AddColorScale, FormatConditions.AddColorScale y Range.FormatConditions

For Each

A continuación, se muestra un ejemplo de cómo procesar los elementos ColorScale en una colección.

Dim cseFormatCondition As ColorScale
For Each cseFormatCondition In ActiveCell.FormatConditions
	
Next cseFormatCondition

Temas

Los siguientes procedimientos de esta clase se han agrupado y se describen en una página temática separada

Add with its procedures FormatConditions.Add, FormatConditions.AddAboveAverage, FormatConditions.AddDatabar, FormatConditions.AddIconSetCondition y FormatConditions.AddTop10

Métodos

Los principales métodos de la clase ColorScale son

Delete - Elimina el objeto de reglas de formato condicional especificado.

ActiveCell.FormatConditions(1).Delete

FormatConditions.AddColorScale - Devuelve un nuevo objeto ColorScale que representa una regla de formato condicional que utiliza gradaciones en los colores de celda para indicar las diferencias relativas entre los valores de las celdas incluidas en un rango seleccionado.

Dim lngColorScaleType As Long: lngColorScaleType = 
Dim cseAddColorScale As ColorScale
Set cseAddColorScale = ActiveCell.FormatConditions.AddColorScale(ColorScaleType:=lngColorScaleType)

FormatConditions.AddUniqueValues - Devuelve un nuevo objeto UniqueValues que representa una regla de formato condicional para el rango especificado.

Dim uvsAddUniqueValues As UniqueValues
Set uvsAddUniqueValues = ActiveCell.FormatConditions.AddUniqueValues()

FormatConditions.Delete - Elimina el objeto.

ActiveCell.FormatConditions.Delete

Otros Métodos

ModifyAppliesToRange - Establece el rango de celdas al que se aplica esta regla de formato.

SetFirstPriority - Establece el valor de prioridad para esta regla de formato condicional en "1" para que se evalúe antes que todas las demás reglas en la hoja de cálculo.

SetLastPriority - Establece el orden de evaluación para esta regla de formato condicional para que se evalúe después que todas las demás reglas en la hoja de cálculo.

FormatConditions.Item - Devuelve un solo objeto de una colección.

Propiedades

AppliesTo Devuelve un objeto Range que especifica el rango de celdas al que se aplica la regla de formato.

Dim rngAppliesTo As Range
Set rngAppliesTo = ActiveCell.FormatConditions(1).AppliesTo

ColorScaleCriteria Devuelve un objeto ColorScaleCriteria , que es una colección de objetos ColorScaleCriterion individuales.

Dim cscColorScaleCriteria As ColorScaleCriteria
Set cscColorScaleCriteria = ActiveCell.FormatConditions(1).ColorScaleCriteria

Formula Devuelve o establece un valor String que representa una fórmula que determina los valores a los que se aplicará el conjunto de iconos.

ActiveCell.FormatConditions(1).Formula =

Parent Devuelve el objeto primario del objeto especificado.

Dim objParent As Object
Set objParent = ActiveCell.FormatConditions(1).Parent

Priority Devuelve o establece el valor de prioridad de la regla de formato condicional.

ActiveCell.FormatConditions(1).Priority =

PTCondition Devuelve un valor Boolean que indica si el formato condicional se aplica a una tabla dinámica.

Dim booPTCondition As Boolean
booPTCondition = ActiveCell.FormatConditions(1).PTCondition

ScopeType Devuelve o establece una de las constantes de la enumeración XlPivotConditionScope , que determina el ámbito del formato condicional cuando se aplica a una tabla dinámica.

ActiveCell.FormatConditions(1).ScopeType = xlDataFieldScope

StopIfTrue Devuelve o establece un valor Boolean que determina si se deben evaluar reglas adicionales de formato en la celda si la regla actual da como resultado True.

Dim booStopIfTrue As Boolean
booStopIfTrue = ActiveCell.FormatConditions(1).StopIfTrue

Type Devuelve una de las constantes de la enumeración XlFormatConditionType , que especifica el tipo de formato condicional.

Dim xlfcType As XlFormatConditionType
xlfcType = ActiveCell.FormatConditions(1).Type

FormatConditions.Count Devuelve un valor Long que representa el número de objetos de la colección.

Dim lngCount As Long
lngCount = ActiveCell.FormatConditions.Count

FormatConditions.Parent Devuelve el objeto primario del objeto especificado.

Dim objParent As Object
Set objParent = ActiveCell.FormatConditions.Parent