FormatCondition

FormatCondition class

Stellt die bedingte Formatierungsbedingung dar.

public class FormatCondition

Eigenschaften

NameBeschreibung
AboveAverage { get; }Abrufen der „AboveAverage“-Instanz der bedingten Formatierung. Die Regel der Standardinstanz hebt Zellen hervor, die über dem Durchschnitt aller Werte im Bereich liegen. Nur gültig für type = AboveAverage.
ColorScale { get; }Abrufen der „ColorScale“-Instanz der bedingten Formatierung. Die Standardinstanz ist eine „grün-gelb-rote“ 3ColorScale . Nur gültig für type = ColorScale.
DataBar { get; }Abrufen der „DataBar“-Instanz der bedingten Formatierung. Die Farbe der Standardinstanz ist blau. Gültig nur für den Typ DataBar.
Formula1 { get; set; }Ruft den Wert oder Ausdruck ab, der der bedingten Formatierung zugeordnet ist, und legt ihn fest.
Formula2 { get; set; }Ruft den Wert oder Ausdruck ab, der der bedingten Formatierung zugeordnet ist, und legt ihn fest.
IconSet { get; }Abrufen der „IconSet“-Instanz der bedingten Formatierung. Der IconSetType der Standardinstanz ist TrafficLights31. Nur gültig für type = IconSet.
Operator { get; set; }Ruft den Typ des bedingten Formatoperators ab und legt ihn fest.
Priority { get; set; }Die Priorität dieser Regel zur bedingten Formatierung. Dieser Wert wird verwendet, um zu bestimmen, welches -Format ausgewertet und gerendert werden soll. Niedrigere numerische Werte haben eine höhere Priorität als höhere numerische Werte, wobei „1“ die höchste Priorität ist.
StopIfTrue { get; set; }True, keine Regeln mit niedrigerer Priorität können über diese Regel angewendet werden, wenn diese Regel als wahr ausgewertet wird. Gilt nur für Excel 2007;
Style { get; set; }Ruft den Stil von bedingt formatierten Zellbereichen ab oder legt ihn fest.
Text { get; set; }Der Textwert in einer bedingten Formatierungsregel “Text enthält”. Nur gültig für type = containsText, notContainsText, beginWith und endedWith. Der Standardwert ist null.
TimePeriod { get; set; }Der anwendbare Zeitraum in einer bedingten Formatierungsregel „Datum auftritt…“. Nur gültig für type = timePeriod. Der Standardwert ist TimePeriodType.Today.
Top10 { get; }Abrufen der „Top10“-Instanz der bedingten Formatierung. Die Regel der Standardinstanz hebt Zellen hervor, deren Werte in die obersten 10 Klammern fallen. Nur gültig für den Typ „Top10“.
Type { get; set; }Ruft ab und legt fest, ob das bedingte Format Type.

Methoden

NameBeschreibung
GetFormula1(bool, bool)Ruft den Wert oder Ausdruck ab, der dieser Formatbedingung zugeordnet ist.
GetFormula1(int, int)Ruft die Formel der bedingten Formatierung der Zelle ab.
GetFormula1(bool, bool, int, int)Ruft den Wert oder Ausdruck der bedingten Formatierung der Zelle ab.
GetFormula2(bool, bool)Ruft den Wert oder Ausdruck ab, der dieser Formatbedingung zugeordnet ist.
GetFormula2(int, int)Ruft die Formel der bedingten Formatierung der Zelle ab.
GetFormula2(bool, bool, int, int)Ruft den Wert oder Ausdruck der bedingten Formatierung der Zelle ab.
SetFormula1(string, bool, bool)Legt den Wert oder Ausdruck fest, der dieser Formatbedingung zugeordnet ist.
SetFormula2(string, bool, bool)Legt den Wert oder Ausdruck fest, der dieser Formatbedingung zugeordnet ist.
SetFormulas(string, string, bool, bool)Legt den Wert oder Ausdruck fest, der dieser Formatbedingung zugeordnet ist.

Beispiele


[C#]
//Instanziieren eines Workbook-Objekts
Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];
 
//Fügt eine leere bedingte Formatierung hinzu
int index = sheet.ConditionalFormattings.Add();
FormatConditionCollection fcs = sheet.ConditionalFormattings[index];
 
//Legt den bedingten Formatbereich fest.
CellArea ca = new CellArea();
ca.StartRow = 0;
ca.EndRow = 0;
ca.StartColumn = 0;
ca.EndColumn = 0;
fcs.AddArea(ca);
 
ca = new CellArea();
ca.StartRow = 1;
ca.EndRow = 1;
ca.StartColumn = 1;
ca.EndColumn = 1;
fcs.AddArea(ca);
 
//Bedingung hinzufügen.
int conditionIndex = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "=A2", "100");
 
//Bedingung hinzufügen.
int conditionIndex2 = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "50", "100");
 
//Setzt die Hintergrundfarbe.
FormatCondition fc = fcs[conditionIndex];
fc.Style.BackgroundColor = Color.Red;
 
//Speichern der Excel-Datei
workbook.Save("output.xls");

[VB.NET]

'Instanziieren eines Workbook-Objekts
Dim workbook As Workbook = New Workbook()
Dim sheet As Worksheet = workbook.Worksheets(0)
 
' Fügt eine leere bedingte Formatierung hinzu
Dim index As Integer = sheet.ConditionalFormattings.Add()
Dim fcs As FormatConditionCollection = sheet.ConditionalFormattings(index)
 
'Legt den bedingten Formatbereich fest.
Dim ca As CellArea = New CellArea()
ca.StartRow = 0
ca.EndRow = 0
ca.StartColumn = 0
ca.EndColumn = 0
fcs.AddArea(ca)
ca = New CellArea()
ca.StartRow = 1
ca.EndRow = 1
ca.StartColumn = 1
ca.EndColumn = 1
fcs.AddArea(ca)
 
'Fügt Bedingung hinzu.
Dim conditionIndex As Integer = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "=A2", "100")
 
'Fügt Bedingung hinzu.
Dim conditionIndex2 As Integer = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "50", "100")
 
'Legt die Hintergrundfarbe fest.
Dim fc As FormatCondition = fcs(conditionIndex)
fc.Style.BackgroundColor = Color.Red
 
'Speichern der Excel-Datei
workbook.Save("output.xls")

Siehe auch