DataValidation — Aspose.Cells FOSS for Python API Reference

Το aspose-cells-foss υποστηρίζει την προσθήκη κανόνων επικύρωσης δεδομένων σε περιοχές κελιών. Οι κανόνες επικύρωσης διαχειρίζονται μέσω ws.data_validations, ένα DataValidationCollection συνδεδεμένο με κάθε Worksheet.

ColladaSaveOptions: aspose.cells_foss

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

DataValidationType

DataValidationType είναι ένα IntEnum που προσδιορίζει τον τύπο του περιορισμού που θα εφαρμοστεί.

DataValidationOperator

DataValidationOperator είναι ένα IntEnum που καθορίζει τον τελεστή σύγκρισης που χρησιμοποιείται με περιορισμούς αριθμητικών/ημερομηνίας/ώρας/μήκους.

DataValidationAlertStyle

DataValidationAlertStyle είναι ένα IntEnum έλεγχος του τρόπου που αντιδρά το Excel όταν εισάγονται μη έγκυρα δεδομένα.

DataValidationImeMode

DataValidationImeMode είναι ένα IntEnum ελέγχει τη λειτουργία IME (Input Method Editor) για εισαγωγή κειμένου Ανατολικής Ασίας.

DataValidation

Ένα DataValidation αντικείμενο περιγράφει έναν μοναδικό κανόνα επικύρωσης και την περιοχή κελιών (sqref) στην οποία εφαρμόζεται.

ColladaSaveOptions

DataValidation(sqref=None)

ColladaSaveOptions

ColladaSaveOptions

copy

validation.copy() -> DataValidation

Επιστρέφει ένα βαθύ αντίγραφο αυτού του κανόνα επικύρωσης.

DataValidationCollection

DataValidationCollection προσπελάζεται ως ws.data_validations. Διαχειρίζεται όλους τους κανόνες επικύρωσης σε ένα φύλλο εργασίας.

ColladaSaveOptions

add

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

Δημιουργεί και καταχωρεί έναν νέο κανόνα επικύρωσης με μία κλήση. Επιστρέφει το δημιουργημένο DataValidation αντικείμενο.

add_validation

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

Καταχωρεί ένα προρυθμισμένο DataValidation αντικείμενο. Επιστρέφει το ίδιο αντικείμενο.

remove

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

Αφαιρεί έναν κανόνα επικύρωσης με αναφορά. Επιστρέφει True αν ο κανόνας βρέθηκε και αφαιρέθηκε.

remove_at

ws.data_validations.remove_at(index: int)

Αφαιρεί τον κανόνα επικύρωσης στον δοσμένο δείκτη που ξεκινά από το μηδέν.

remove_by_range

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

Αφαιρεί όλες τις επικυρώσεις των οποίων sqref επικαλύπτει το δοσμένο εύρος. Επιστρέφει τον αριθμό των κανόνων που αφαιρέθηκαν.

clear

ws.data_validations.clear()

Αφαιρεί όλους τους κανόνες επικύρωσης από το φύλλο εργασίας.

get_validation

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

Επιστρέφει τον κανόνα επικύρωσης που εφαρμόζεται στην δεδομένη αναφορά κελιού (π.χ.,)., "B5"), ή None αν δεν ισχύει κανένα.

Ιδιότητες και Επανάληψη

ColladaSaveOptions

Επικύρωση Λίστας Αναπτυσσόμενου Μενού

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

Επικύρωση Αριθμητικού Εύρους

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

Δείτε επίσης

• Cells Python API Reference αρχική
• Αναφορά κλάσης Workbook
• Αναφορά κλάσης Worksheet
• Ξεκινώντας