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 |
|---|---|
| formula1 | Obtient et définit la valeur ou l’expression associée à la mise en forme conditionnelle. |
| formula2 | Obtient et définit la valeur ou l’expression associée à la mise en forme conditionnelle. |
| operator | Obtient et définit le type d’opérateur de format conditionnel. |
| stop_if_true | True, aucune règle avec une priorité inférieure ne peut être appliquée sur cette règle, lorsque cette règle est évaluée à true.
S’applique uniquement à Excel 2007 ; |
| priority | Priorité de cette règle de mise en forme conditionnelle. Cette valeur est utilisée pour déterminer quel
format doit être évalué et rendu. Les valeurs numériques inférieures ont une priorité plus élevée que des valeurs numériques plus élevées, où ‘1’ est la priorité la plus élevée. |
| style | Obtient ou définit le style des plages de cellules mises en forme conditionnelles. |
| type | Obtient et définit si le format conditionnel Type. |
| icon_set | Obtenez l’instance “IconSet” de la mise en forme conditionnelle.
L’IconSetType de l’instance par défaut est TrafficLights31. Valable uniquement pour le type = IconSet. |
| data_bar | Obtenez l’instance “DataBar” de la mise en forme conditionnelle.
La couleur de l’instance par défaut est le bleu. Valide uniquement pour le type est DataBar. |
| color_scale | Obtenez 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. |
| top10 | Obtenez 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 les 10 premières tranches. Valable uniquement pour le type est Top10. |
| above_average | Obtenez 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 gamme. Valable uniquement pour le type = AboveAverage. |
| text | La valeur de texte dans une règle de mise en forme conditionnelle “le texte contient”.
Valide uniquement pour type = containsText, notContainsText, beginWith et endsWith. La valeur par défaut est nulle. |
| time_period | La période applicable dans une règle de mise en forme conditionnelle “date survenant…”.
Valide uniquement pour type = timePeriod. La valeur par défaut est TimePeriodType.Today. |
Méthodes
| Méthode | Description |
|---|---|
| get_formula1(is_r1c1, is_local) | Obtient la valeur ou l’expression associée à cette condition de format. |
| get_formula1(is_r1c1, is_local, row, column) | Obtient la valeur ou l’expression de la mise en forme conditionnelle de la cellule. |
| get_formula1(row, column) | Obtient la formule de la mise en forme conditionnelle de la cellule. |
| get_formula2(is_r1c1, is_local) | Obtient la valeur ou l’expression associée à cette condition de format. |
| get_formula2(is_r1c1, is_local, row, column) | Obtient la valeur ou l’expression de la mise en forme conditionnelle de la cellule. |
| get_formula2(row, column) | Obtient la formule de la mise en forme conditionnelle de la cellule. |
| set_formulas(formula1, formula2, is_r1c1, is_local) | Définit la valeur ou l’expression associée à cette condition de format. |
| set_formula1(formula, is_r1c1, is_local) | Définit la valeur ou l’expression associée à cette condition de format. |
| set_formula2(formula, is_r1c1, is_local) | Dé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
- module aspose.cells
