Aspose.Cells FOSS - Fosses.
Python
DataValidation

DataValidation — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss admet afegir regles de validació de dades a intervals de cel·les. Les regles de validació es gestionen a través de ws.data_validations, un DataValidationCollection adjunt a cada Worksheet.

Enumerations: aspose.cells_foss

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

DataValidationType

DataValidationType és un IntEnum que identifica el tipus de restricció a aplicar.

EnumerationsEnumerationsEnumerations
NONE0Cap restricció de validació.
WHOLE_NUMBER1Accepta només enters.
DECIMAL2Accepta nombres decimals.
LIST3Accepta valors d’una llista desplegable.
DATE4Accepta només valors de data.
TIME5Accepta només valors d’hora.
TEXT_LENGTH6Valida per longitud del text.
CUSTOM7Valida mitjançant una fórmula personalitzada.

DataValidationOperator

DataValidationOperator és un IntEnum especifica l’operador de comparació utilitzat amb restriccions numèriques/de data/de temps/de longitud.

EnumerationsEnumerations
BETWEEN0
NOT_BETWEEN1
EQUAL2
NOT_EQUAL3
GREATER_THAN4
LESS_THAN5
GREATER_THAN_OR_EQUAL6
LESS_THAN_OR_EQUAL7

DataValidationAlertStyle

DataValidationAlertStyle és un IntEnum controla com reacciona Excel quan s’introdueixen dades no vàlides.

EnumerationsEnumerationsEnumerations
STOP0Rebutja l’entrada i mostra un diàleg d’error (per defecte).
WARNING1Mostra un avís però permet l’entrada.
INFORMATION2Mostra un missatge informatiu però sempre permet l’entrada.

DataValidationImeMode

DataValidationImeMode és un IntEnum controla el mode IME (Editor de Mètode d’Entrada) per a la introducció de text d’Àsia Oriental.

EnumerationsEnumerations
NO_CONTROL0
OFF1
ON2
DISABLED3
HIRAGANA4
FULL_KATAKANA5
HALF_KATAKANA6
FULL_ALPHA7
HALF_ALPHA8
FULL_HANGUL9
HALF_HANGUL10

DataValidation

A DataValidation l’objecte descriu una única regla de validació i el rang de cel·les (sqref) al qual s’aplica.

Enumerations 

DataValidation(sqref=None)
EnumerationsEnumerationsEnumerations
sqref`strNone`

Enumerations

EnumerationsEnumerationsEnumerations
sqrefstrEl rang de cel·les per a aquesta regla (p. ex., "B2:B100").
typeDataValidationTypeTipus de validació (nombre sencer, decimal, llista, data, hora, longitud de text o personalitzat).
operatorDataValidationOperatorOperador de comparació aplicat a formula1 (i formula2 per a BETWEEN/NOT_BETWEEN).
formula1strLímit inferior, origen de la llista (p. ex., '"Apple,Banana,Cherry"'),.
formula2strLímit superior per a BETWEEN i NOT_BETWEEN operadors.
alert_styleDataValidationAlertStyleCom Excel respon a una entrada no vàlida (STOP, WARNING, o INFORMATION).
show_error_messageboolTrue per mostrar el diàleg de missatge d’error en una entrada no vàlida.
error_titlestrTítol del diàleg d’error (màx. 32 caràcters).
error_messagestrCos del diàleg d’error (màx. 225 caràcters).
show_input_messageboolTrue per mostrar un missatge d’indicació d’entrada quan la cel·la està seleccionada.
input_titlestrTítol del missatge d’entrada (màx. 32 caràcters).
input_messagestrCos del missatge d’entrada (màx. 255 caràcters).
allow_blankboolTrue per permetre cel·les en blanc (buides) sense activar l’error.
show_dropdownboolTrue per mostrar una fletxa desplegable per a validacions de llista.
ime_modeDataValidationImeModeMode IME per a l’entrada de text d’Àsia Oriental.

Enumerations

copia 

validation.copy() -> DataValidation

Retorna una còpia profunda d’aquesta regla de validació.

DataValidationCollection

DataValidationCollection s’accedeix com a ws.data_validations. Gestiona totes les regles de validació en un full de càlcul.

Enumerations

add 

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

Crea i registra una nova regla de validació en una sola crida. Retorna la regla creada DataValidation objecte.

add_validation 

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

Registra un pre-configurat DataValidation objecte. Retorna el mateix objecte.

remove 

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

Elimina una regla de validació per referència. Retorna True si s’ha trobat i eliminat la regla.

remove_at 

ws.data_validations.remove_at(index: int)

Elimina la regla de validació a l’índex zero-basat indicat.

remove_by_range 

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

Elimina totes les validacions que sqref se superposen amb el rang indicat. Retorna el nombre de regles eliminades.

clear 

ws.data_validations.clear()

Elimina totes les regles de validació del full de càlcul.

get_validation 

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

Retorna la regla de validació que s’aplica a la referència de cel·la indicada (p. ex., "B5"), o None si cap s’aplica.

Propietats i iteració

EnumerationsEnumerations
countNombre de regles de validació en aquest full de càlcul (només lectura).
disable_promptsbool — Establir a True per suprimir globalment tots els missatges d’entrada.
__len__()Enumerations count.
__iter__()Itera sobre tots els DataValidation objectes.
__getitem__(index)Retorna el DataValidation a base zero index.

Enumerations

Validació de llista desplegable 

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

Validació d’interval numèric 

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

Vegeu també

 Català