FormatCondition classe

FormatCondition classe

Rappresenta la condizione di formattazione condizionale.

Il tipo FormatCondition espone i seguenti membri:

Proprietà

ProprietàDescrizione
formula1Ottiene e imposta il valore o l’espressione associata alla formattazione condizionale.
formula2Ottiene e imposta il valore o l’espressione associata alla formattazione condizionale.
operatorOttiene e imposta il tipo di operatore di formato condizionale.
stop_if_trueVero, nessuna regola con priorità inferiore può essere applicata a questa regola, quando questa regola viene valutata come vera.
Si applica solo a Excel 2007;
priorityLa priorità di questa regola di formattazione condizionale. Questo valore viene utilizzato per determinare quale
il formato dovrebbe essere valutato e reso. I valori numerici più bassi hanno una priorità maggiore rispetto a
valori numerici più elevati, dove ‘1’ rappresenta la priorità più alta.
styleOttiene o imposta lo stile degli intervalli di celle formattate in modo condizionale.
typeOttiene e imposta se il formato condizionale è Type.
icon_setOttieni l’istanza “IconSet” della formattazione condizionale.
L’IconSetType dell’istanza predefinita è TrafficLights31.
Valido solo per il tipo = IconSet.
data_barOttieni l’istanza “DataBar” della formattazione condizionale.
Il colore predefinito dell’istanza è blu.
Valido solo per il tipo DataBar.
color_scaleOttieni l’istanza “ColorScale” della formattazione condizionale.
L’istanza predefinita è 3ColorScale “verde-giallo-rosso”.
Valido solo per tipo = ColorScale.
top10Ottieni l’istanza “Top10” della formattazione condizionale.
La regola dell’istanza predefinita evidenzia le celle la cui
i valori rientrano nella fascia dei primi 10.
Valido solo per il tipo Top10.
above_averageOttieni l’istanza “AboveAverage” della formattazione condizionale.
La regola dell’istanza predefinita evidenzia le celle che sono
al di sopra della media di tutti i valori nell’intervallo.
Valido solo per tipo = AboveAverage.
textValore di testo in una regola di formattazione condizionale “testo contiene”.
Valido solo per i tipi = containsText, notContainsText, beginsWith e endsWith.
Il valore predefinito è null.
time_periodPeriodo di tempo applicabile in una regola di formattazione condizionale “data di ricorrenza…”.
Valido solo per tipo = timePeriod.
Il valore predefinito è TimePeriodType.Today.

Metodi

MetodoDescrizione
get_formula1(self, is_r1c1, is_local)Ottiene il valore o l’espressione associata a questa condizione di formato.
get_formula1(self, is_r1c1, is_local, row, column)Ottiene il valore o l’espressione della formattazione condizionale della cella.
get_formula1(self, row, column)Ottiene la formula della formattazione condizionale della cella.
get_formula2(self, is_r1c1, is_local)Ottiene il valore o l’espressione associata a questa condizione di formato.
get_formula2(self, is_r1c1, is_local, row, column)Ottiene il valore o l’espressione della formattazione condizionale della cella.
get_formula2(self, row, column)Ottiene la formula della formattazione condizionale della cella.
set_formulas(self, formula1, formula2, is_r1c1, is_local)Imposta il valore o l’espressione associata a questa condizione di formato.
set_formula1(self, formula, is_r1c1, is_local)Imposta il valore o l’espressione associata a questa condizione di formato.
set_formula2(self, formula, is_r1c1, is_local)Imposta il valore o l’espressione associata a questa condizione di formato.

Esempio

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")

Guarda anche