DataValidation — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss prend en charge l’ajout de règles de validation de données aux plages de cellules. Les règles de validation sont gérées via ws.data_validations, un DataValidationCollection attaché à chaque Worksheet.

ColladaSaveOptions: aspose.cells_foss

from aspose.cells_foss import (
    DataValidationType, DataValidationOperator,
    DataValidationAlertStyle, DataValidationImeMode,
    DataValidation, DataValidationCollection,
)

DataValidationType

DataValidationType est un IntEnum identifiant le type de contrainte à appliquer.

DataValidationOperator

DataValidationOperator est un IntEnum spécifiant l’opérateur de comparaison utilisé avec les contraintes numériques/date/heure/longueur.

DataValidationAlertStyle

DataValidationAlertStyle est un IntEnum contrôlant la façon dont Excel réagit lorsqu’une donnée invalide est saisie.

DataValidationImeMode

DataValidationImeMode est un IntEnum contrôlant le mode IME (Input Method Editor) pour la saisie de texte d’Asie de l’Est.

DataValidation

A DataValidation l’objet décrit une règle de validation unique et la plage de cellules (sqref) à laquelle elle s’applique.

ColladaSaveOptions

DataValidation(sqref=None)

ColladaSaveOptions

ColladaSaveOptions

copy

validation.copy() -> DataValidation

Renvoie une copie profonde de cette règle de validation.

DataValidationCollection

DataValidationCollection est accessible en tant que ws.data_validations. Il gère toutes les règles de validation sur une feuille de calcul.

ColladaSaveOptions

add

ws.data_validations.add(
    sqref,
    validation_type=None,
    operator=None,
    formula1=None,
    formula2=None
) -> DataValidation

Crée et enregistre une nouvelle règle de validation en un seul appel. Renvoie le/la créé(e) DataValidation objet.

add_validation

ws.data_validations.add_validation(validation: DataValidation) -> DataValidation

Enregistre un(e) pré-configuré(e) DataValidation objet. Retourne le même objet.

remove

ws.data_validations.remove(validation: DataValidation) -> bool

Supprime une règle de validation par référence. Retourne True si la règle a été trouvée et supprimée.

remove_at

ws.data_validations.remove_at(index: int)

Supprime la règle de validation à l’index basé sur zéro indiqué.

remove_by_range

ws.data_validations.remove_by_range(sqref: str) -> int

Supprime toutes les validations dont le sqref chevauche la plage donnée. Retourne le nombre de règles supprimées.

clear

ws.data_validations.clear()

Supprime toutes les règles de validation de la feuille de calcul.

get_validation

ws.data_validations.get_validation(cell_ref: str) -> DataValidation | None

Retourne la règle de validation qui s’applique à la référence de cellule donnée (par ex., "B5"), ou None si aucune ne s’applique.

Propriétés et itération

ColladaSaveOptions

Validation par liste déroulante

from aspose.cells_foss import Workbook, DataValidationType, DataValidationAlertStyle

wb = Workbook()
ws = wb.worksheets[0]

# Write a label
ws.cells["A1"].put_value("Status")

# Add a dropdown list to A2:A20
dv = ws.data_validations.add(
    sqref="A2:A20",
    validation_type=DataValidationType.LIST,
    formula1='"Open,In Progress,Closed,Cancelled"',
)
dv.show_dropdown = True
dv.allow_blank = True
dv.alert_style = DataValidationAlertStyle.STOP
dv.show_error_message = True
dv.error_title = "Invalid Status"
dv.error_message = "Please select a value from the list."
dv.show_input_message = True
dv.input_title = "Status"
dv.input_message = "Choose a status from the dropdown."

wb.save("dropdown_validation.xlsx")

Validation de plage numérique

from aspose.cells_foss import (
    Workbook, DataValidationType, DataValidationOperator,
    DataValidationAlertStyle,
)

wb = Workbook()
ws = wb.worksheets[0]

ws.cells["B1"].put_value("Score (0–100)")

# Whole number between 0 and 100
dv = ws.data_validations.add(
    sqref="B2:B50",
    validation_type=DataValidationType.WHOLE_NUMBER,
    operator=DataValidationOperator.BETWEEN,
    formula1="0",
    formula2="100",
)
dv.allow_blank = False
dv.alert_style = DataValidationAlertStyle.WARNING
dv.show_error_message = True
dv.error_title = "Out of Range"
dv.error_message = "Score must be between 0 and 100."

wb.save("range_validation.xlsx")

Voir aussi

• Cells Python Référence API accueil
• Référence de la classe Workbook
• Référence de la classe Worksheet
• Premiers pas