FormatCondition Klasse

FormatCondition Klasse

Stellt eine Bedingung für die bedingte Formatierung dar.

Der Typ FormatCondition macht die folgenden Member verfügbar:

Eigenschaften

EigentumBeschreibung
formula1Ruft den mit der bedingten Formatierung verknüpften Wert oder Ausdruck ab und legt ihn fest.
formula2Ruft den mit der bedingten Formatierung verknüpften Wert oder Ausdruck ab und legt ihn fest.
operatorRuft den Operatortyp für das bedingte Format ab und legt ihn fest.
stop_if_trueTrue: Wenn diese Regel als „true“ ausgewertet wird, dürfen keine Regeln mit niedrigerer Priorität auf diese Regel angewendet werden.
Gilt nur für Excel 2007;
priorityDie Priorität dieser Regel zur bedingten Formatierung. Dieser Wert wird verwendet, um zu bestimmen, welche
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 hat.
styleRuft den Stil bedingt formatierter Zellbereiche ab oder legt ihn fest.
typeRuft ab und legt fest, ob der Typ des bedingten Formats verwendet wird.
icon_setHolen Sie sich die „IconSet“-Instanz der bedingten Formatierung.
Der IconSetType der Standardinstanz ist TrafficLights31.
Nur gültig für Typ = IconSet.
data_barHolen Sie sich die „DataBar“-Instanz der bedingten Formatierung.
Die Standardfarbe der Instanz ist Blau.
Nur gültig für den Typ „DataBar“.
color_scaleHolen Sie sich die „ColorScale“-Instanz der bedingten Formatierung.
Die Standardinstanz ist eine „grün-gelb-rote“ 3-Farbskala.
Nur gültig für Typ = Farbskala.
top10Holen Sie sich die „Top10“-Instanz der bedingten Formatierung.
Die Regel der Standardinstanz hebt Zellen hervor, deren
Die Werte liegen im oberen Zehntelbereich.
Nur gültig für den Typ „Top10“.
above_averageHolen Sie sich die Instanz „Überdurchschnittlich“ der bedingten Formatierung.
Die Regel der Standardinstanz hebt Zellen hervor, die
über dem Durchschnitt aller Werte im Bereich.
Nur gültig für Typ = Überdurchschnittlich.
textDer Textwert in einer bedingten Formatierungsregel „Text enthält“.
Nur gültig für Typ = containsText, notContainsText, beginsWith und endsWith.
Der Standardwert ist null.
time_periodDer anwendbare Zeitraum in einer Regel zur bedingten Formatierung vom Typ „Datum, an dem …“
Nur gültig für Typ = Zeitraum.
Der Standardwert ist TimePeriodType.Today.

Methoden

MethodeBeschreibung
get_formula1(self, is_r1c1, is_local)Ruft den Wert oder Ausdruck ab, der dieser Formatbedingung zugeordnet ist.
get_formula1(self, is_r1c1, is_local, row, column)Ruft den Wert oder Ausdruck der bedingten Formatierung der Zelle ab.
get_formula1(self, row, column)Ruft die Formel der bedingten Formatierung der Zelle ab.
get_formula2(self, is_r1c1, is_local)Ruft den Wert oder Ausdruck ab, der dieser Formatbedingung zugeordnet ist.
get_formula2(self, is_r1c1, is_local, row, column)Ruft den Wert oder Ausdruck der bedingten Formatierung der Zelle ab.
get_formula2(self, row, column)Ruft die Formel der bedingten Formatierung der Zelle ab.
set_formulas(self, formula1, formula2, is_r1c1, is_local)Legt den Wert oder Ausdruck fest, der mit dieser Formatbedingung verknüpft ist.
set_formula1(self, formula, is_r1c1, is_local)Legt den Wert oder Ausdruck fest, der mit dieser Formatbedingung verknüpft ist.
set_formula2(self, formula, is_r1c1, is_local)Legt den Wert oder Ausdruck fest, der mit dieser Formatbedingung verknüpft ist.

Beispiel

from aspose.cells import CellArea, FormatConditionType, OperatorType, Workbook
from aspose.pydrawing import Color

# Instantiating a Workbook object
workbook = Workbook()
sheet = workbook.worksheets[0]
# Adds an empty conditional formatting
index = sheet.conditional_formattings.add()
fcs = sheet.conditional_formattings[index]
# Sets the conditional format range.
ca = CellArea()
ca.start_row = 0
ca.end_row = 0
ca.start_column = 0
ca.end_column = 0
fcs.add_area(ca)
ca = CellArea()
ca.start_row = 1
ca.end_row = 1
ca.start_column = 1
ca.end_column = 1
fcs.add_area(ca)
# Adds condition.
conditionIndex = fcs.add_condition(FormatConditionType.CELL_VALUE, OperatorType.BETWEEN, "=A2", "100")
# Adds condition.
conditionIndex2 = fcs.add_condition(FormatConditionType.CELL_VALUE, OperatorType.BETWEEN, "50", "100")
# Sets the background color.
fc = fcs[conditionIndex]
fc.style.background_color = Color.red
# Saving the Excel file
workbook.save("output.xls")

Siehe auch