ColorScale Schnittstelle

Referenz

Definition

Namespace:: Microsoft.Office.Interop.Excel

Assembly:: Microsoft.Office.Interop.Excel.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt eine Regel zur bedingten Formatierung einer Farbskala dar.

public interface class ColorScale

[System.Runtime.InteropServices.Guid("00024493-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface ColorScale

Public Interface ColorScale

Attribute: GuidAttribute InterfaceTypeAttribute

Beispiele

Im folgenden Codebeispiel wird ein Zahlenbereich erstellt und dann eine Regel zur bedingten Formatierung von Farbskalen mit zwei Farben auf den Bereich angewendet. Die Farbe für den niedrigsten Schwellenwert wird dann auf Rot und die des maximalen Schwellenwerts auf Blau festgelegt.

<span class="label">Sub CreateColorScaleCF() 































































































































































































































































    Dim cfColorScale As </span>
<i>ColorScale</i>
<span class="label">'Fill cells with sample data from 1 to 10     With ActiveSheet         .Range("C1") = 1         .Range("C2") = 2         .Range("C1:C2").AutoFill Destination:=Range("C1:C10")     End With          Range("C1:C10").Select          'Create a two-color ColorScale object for the created sample data range     Set cfColorScale = Selection.FormatConditions.AddColorScale(ColorScaleType:=2)          'Set the minimum threshold to red and maximum threshold to blue     cfColorScale.ColorScaleCriteria(1).FormatColor.Color = RGB(255, 0, 0)     cfColorScale.ColorScaleCriteria(2).FormatColor.Color = RGB(0, 0, 255)          End Sub</span>

Hinweise

Alle Objekte der bedingten Formatierung sind in einem FormatConditions Auflistungsobjekt enthalten, das ein untergeordnetes Element einer Range Auflistung ist. Sie können eine Farbskalaformatierungsregel erstellen, indem Sie entweder die -Methode oder AddColorScale(Int32) die Add(XlFormatConditionType, Object, Object, Object, Object, Object, Object, Object) -Methode der FormatConditions-Auflistung verwenden.

Bei Farbskalen handelt es sich um visuelle Hilfen, durch die Sie die Datenverteilung und -streuung leichter erkennen können. Sie können auf einen Datenbereich, Daten in einer Tabelle oder Daten in einem PivotTable-Bericht Skalen mit zwei oder drei Farben anwenden. Bei einer bedingten Formatierung mit zwei Farben weisen Sie den Wert, Typ und die Farbe den niedrigsten und höchsten Schwellenwerten eines Bereichs zu. Eine Farbskala mit drei Farben verfügt außerdem über eine mittlere Schwelle.

Jeder dieser Schwellenwerte wird durch Festlegen der Eigenschaften des ColorScaleCriteria -Objekts bestimmt. Das ColorScaleCriteria-Objekt , das ein untergeordnetes Element des ColorScale-Objekts ist, ist eine Auflistung aller ColorScaleCriterion Objekte für die Farbskala.

Eigenschaften

Application	Bei Verwendung ohne Objektqualifizierer gibt diese Eigenschaft ein _Application Objekt zurück, das die Microsoft Office Excel-Anwendung darstellt. Wenn ohne einen Objektbezeichner verwendet wird, gibt diese Eigenschaft ein Application -Objekt, das den Ersteller des angegebenen Objekts darstellt. Schreibgeschützt.
AppliesTo	Gibt ein Range -Objekt zurück, das den Zellbereich angibt, auf den die Formatierungsregel angewendet wird.
ColorScaleCriteria	Gibt ein ColorScaleCriteria -Objekt zurück, bei dem es sich um eine Auflistung einzelner ColorScaleCriterion Objekte handelt. Das ColorScaleCriterion -Objekt gibt den Typ, den Wert und die Farbe der Schwellenwertkriterien an, die im bedingten Format der Farbskala verwendet werden. Schreibgeschützt.
Creator	Gibt eine Konstante in der XlCreator -Enumeration zurück, die die Anwendung angibt, in der dieses Objekt erstellt wurde. Schreibgeschützt.
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.
Parent	Gibt das übergeordnete Objekt für das angegebene Objekt zurück. Schreibgeschützt.
Priority	Gibt den Prioritätswert der Regel zur bedingten Formatierung zurück oder legt ihn fest. Durch die Priorität wird die Reihenfolge der Auswertung bestimmt, wenn für ein Arbeitsblatt mehrere Regeln zur bedingten Formatierung vorhanden sind.
PTCondition	Gibt einen booleschen Wert zurück, der angibt, ob das bedingte Format auf ein PivotTable Diagramm angewendet wird. Schreibgeschützt.
ScopeType	Gibt eine der Konstanten der XlPivotConditionScope Enumeration zurück oder legt sie fest, die den Bereich des bedingten Formats bestimmt, wenn es auf ein PivotTable-Diagramm angewendet wird.
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.
Type	Gibt eine der Konstanten der XlFormatConditionType -Enumeration zurück, die den Typ des bedingten Formats angibt. Schreibgeschützt.

Methoden

Delete()	Löscht das angegebene Regelobjekt für die bedingte Formatierung.
ModifyAppliesToRange(Range)	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 Regel zur bedingten Formatierung fest, sodass sie nach allen anderen Regeln im Arbeitsblatt ausgewertet wird.

Gilt für: