Klasse ColorScale (Excel VBA)

Die Klasse ColorScale stellt eine Regel zur bedingten Formatierung einer Farbskala dar.

Die wichtigste Prozeduren der Klasse ColorScale sind Delete, FormatConditions.Add, FormatConditions.AddAboveAverage, FormatConditions.AddColorScale, FormatConditions.AddDatabar, FormatConditions.AddIconSetCondition, FormatConditions.AddTop10, FormatConditions.AddUniqueValues und FormatConditions.Delete

Set

Um eine ColorScale -Klassenvariable zu verwenden, muss sie zuerst instanziert werden, beispielsweise

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

Die folgenden Prozeduren können zum Festlegen der ColorScale Klassenvariablen verwendet werden : FormatConditions.AddColorScale, FormatConditions.AddColorScale, FormatConditions.AddColorScale, FormatConditions.AddColorScale, FormatConditions.AddColorScale, FormatConditions.AddColorScale, FormatConditions.AddColorScale und Range.FormatConditions

For Each

Hier ist ein Beispiel für die Verarbeitung der ColorScale -Elemente in einer Sammlung

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

Themas

Die folgenden Prozeduren in dieser Klasse wurden zusammengefasst und auf eine separate Themenseite beschrieben

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

Methoden

Die Hauptmethoden der Klasse ColorScale sind

Delete - Löscht das angegebene Regelobjekt für die bedingte Formatierung.

ActiveCell.FormatConditions(1).Delete

FormatConditions.AddColorScale - Gibt ein neues ColorScale -Objekt zurück, das eine Regel zur bedingten Formatierung darstellt, die Abstufungen in Zellfarben verwendet, um die relativen Unterschiede zwischen den Werten der Zellen in einem ausgewählten Bereich anzugeben.

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

FormatConditions.AddUniqueValues - Gibt ein neues UniqueValues -Objekt zurück, das eine Regel zur bedingten Formatierung für den angegebenen Range darstellt.

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

FormatConditions.Delete - Löscht das Objekt.

ActiveCell.FormatConditions.Delete

Andere Methoden

ModifyAppliesToRange - Legt den Zellbereich fest, für den diese Formatierungsregel gilt.

SetFirstPriority - Legt den Prioritätswert für diese Regel zur bedingten Formatierung auf 1 fest, sodass die Regel vor allen anderen Regeln im Arbeitsblatt ausgewertet wird.

SetLastPriority - Legt die Auswertungsreihenfolge für diese bedingte Formatierungsregel so fest, dass Sie nach allen anderen Regeln im Arbeitsblatt ausgewertet wird.

FormatConditions.Item - Gibt ein einzelnes Objekt aus einer Auflistung zurück.

Eigenschaften

AppliesTo Gibt ein Range -Objekt zurück, das den Zellbereich angibt, auf den die Formatierungsregel angewendet wird.

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

ColorScaleCriteria Gibt ein ColorScaleCriteria -Objekt zurück, bei dem es sich um eine Auflistung einzelner ColorScaleCriterion -Objekte handelt.

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

Formula Gibt einen String-Wert zurück oder legt diesen fest, der eine Formel zum Bestimmen der Werte darstellt, auf die der Symbolsatz angewendet wird.

ActiveCell.FormatConditions(1).Formula =

Parent Gibt das übergeordnete Objekt für das angegebene Objekt zurück.

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

Priority Gibt den Prioritätswert der Regel zur bedingten Formatierung zurück oder legt ihn fest.

ActiveCell.FormatConditions(1).Priority =

PTCondition Gibt einen Boolean-Wert zurück, der angibt, ob ein bedingtes Format auf eine PivotTable angewendet wird.

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

ScopeType Gibt eine der Konstanten der XlPivotConditionScope -Aufzählung zurück, die den Bereich der bedingten Formatierung bestimmt, wenn Sie auf eine PivotTable angewendet wird, oder legt diese Konstante fest.

ActiveCell.FormatConditions(1).ScopeType = xlDataFieldScope

StopIfTrue Gibt einen Boolean-Wert zurück, der bestimmt, ob zusätzliche Formatierungsregeln für die Zelle ausgewertet werden sollen, wenn die aktuelle Regel zu True ausgewertet wird, oder legt diesen Wert fest.

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

Type Gibt eine der Konstanten der XlFormatConditionType -Aufzählung zurück, die den Typ des bedingten Formats angibt.

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

FormatConditions.Count Gibt einen Long-Wert zurück, der die Anzahl der Objekte in der Auflistung darstellt.

Dim lngCount As Long
lngCount = ActiveCell.FormatConditions.Count

FormatConditions.Parent Gibt das übergeordnete Objekt für das angegebene Objekt zurück.

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