FormatCondition classe

FormatCondition classe

Représente la condition de mise en forme conditionnelle.

Le type FormatCondition expose les membres suivants :

Propriétés

PropriétéDescription
formula1Obtient et définit la valeur ou l’expression associée à la mise en forme conditionnelle.
formula2Obtient et définit la valeur ou l’expression associée à la mise en forme conditionnelle.
operatorObtient et définit le type d’opérateur de format conditionnel.
stop_if_trueCertes, aucune règle de priorité inférieure ne peut être appliquée à cette règle lorsque celle-ci est évaluée comme vraie.
S’applique uniquement à Excel 2007 ;
priorityPriorité de cette règle de mise en forme conditionnelle. Cette valeur est utilisée pour déterminer quel
Le format doit être évalué et rendu. Les valeurs numériques inférieures ont une priorité plus élevée que
valeurs numériques plus élevées, où « 1 » est la priorité la plus élevée.
styleObtient ou définit le style des plages de cellules mises en forme conditionnellement.
typeObtient et définit si le format conditionnel Type.
icon_setObtenez l’instance “IconSet” de la mise en forme conditionnelle.
Le IconSetType de l’instance par défaut est TrafficLights31.
Valable uniquement pour type = IconSet.
data_barObtenez l’instance “DataBar” de la mise en forme conditionnelle.
La couleur de l’instance par défaut est le bleu.
Valable uniquement pour le type DataBar.
color_scaleObtenez l’instance “ColorScale” de la mise en forme conditionnelle.
L’instance par défaut est un 3ColorScale “vert-jaune-rouge”.
Valable uniquement pour le type = ColorScale.
top10Obtenez l’instance “Top10” de la mise en forme conditionnelle.
La règle de l’instance par défaut met en évidence les cellules dont
les valeurs se situent dans la tranche des 10 premiers.
Valable uniquement pour le type Top10.
above_averageObtenez l’instance “AboveAverage” de la mise en forme conditionnelle.
La règle de l’instance par défaut met en évidence les cellules qui sont
au-dessus de la moyenne pour toutes les valeurs de la plage.
Valable uniquement pour le type = AboveAverage.
textLa valeur du texte dans une règle de mise en forme conditionnelle « le texte contient ».
Valable uniquement pour type = containText, notContainsText, BeginsWith et EndsWith.
La valeur par défaut est nulle.
time_periodPériode de temps applicable dans une règle de formatage conditionnel « date survenant… ».
Valable uniquement pour type = timePeriod.
La valeur par défaut est TimePeriodType.Today.

Méthodes

MéthodeDescription
get_formula1Obtient la valeur ou l’expression associée à cette condition de format.
get_formula1Obtient la valeur ou l’expression de la mise en forme conditionnelle de la cellule.
get_formula1Obtient la formule de mise en forme conditionnelle de la cellule.
get_formula2Obtient la valeur ou l’expression associée à cette condition de format.
get_formula2Obtient la valeur ou l’expression de la mise en forme conditionnelle de la cellule.
get_formula2Obtient la formule de mise en forme conditionnelle de la cellule.
set_formulasDéfinit la valeur ou l’expression associée à cette condition de format.
set_formula1Définit la valeur ou l’expression associée à cette condition de format.
set_formula2Définit la valeur ou l’expression associée à cette condition de format.

Exemple

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

Voir également