Aspose.Cells FOSS - Aspose.CellsKopy
Python
DataValidation

DataValidation — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss podporuje přidávání pravidel ověřování dat do rozsahů buněk. Pravidla ověřování jsou spravována pomocí ws.data_validations, a DataValidationCollection připojený ke každému Worksheet.

Enumerations: aspose.cells_foss

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

DataValidationType

DataValidationType je IntEnum identifikující typ omezení, které se má použít.

EnumerationsEnumerationsEnumerations
NONE0Žádné omezení ověření.
WHOLE_NUMBER1Přijímá pouze celá čísla.
DECIMAL2Přijímá desetinná čísla.
LIST3Přijímá hodnoty z rozbalovacího seznamu.
DATE4Přijímá pouze datumové hodnoty.
TIME5Přijímá pouze časové hodnoty.
TEXT_LENGTH6Ověřuje podle délky textu.
CUSTOM7Ověřuje pomocí vlastní formule.

DataValidationOperator

DataValidationOperator je IntEnum specifikující operátor porovnání používaný u číselných/datových/časových/délkových omezení.

EnumerationsEnumerations
BETWEEN0
NOT_BETWEEN1
EQUAL2
NOT_EQUAL3
GREATER_THAN4
LESS_THAN5
GREATER_THAN_OR_EQUAL6
LESS_THAN_OR_EQUAL7

DataValidationAlertStyle

DataValidationAlertStyle je IntEnum ovládání toho, jak Excel reaguje při zadání neplatných dat.

EnumerationsEnumerationsEnumerations
STOP0Odmítne zadání a zobrazí chybové dialogové okno (výchozí).
WARNING1Zobrazí varování, ale povolí zadání.
INFORMATION2Zobrazí informační zprávu, ale vždy povolí zadání.

DataValidationImeMode

DataValidationImeMode je IntEnum ovládání režimu IME (Input Method Editor) pro zadávání textu východoasijských jazyků.

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

DataValidation

Jedna DataValidation objekt popisuje jediné validační pravidlo a rozsah buněk (sqref) na který se vztahuje.

Enumerations 

DataValidation(sqref=None)
EnumerationsEnumerationsEnumerations
sqref`strNone`

Enumerations

EnumerationsEnumerationsEnumerations
sqrefstrRozsah buněk pro toto pravidlo (např., "B2:B100").
typeDataValidationTypeTyp validace (celé číslo, desetinné, seznam, datum, čas, délka textu nebo vlastní).
operatorDataValidationOperatorPorovnávací operátor aplikovaný na formula1 (a formula2 pro BETWEEN/NOT_BETWEEN).
formula1strDolní mez, zdroj seznamu (např., '"Apple,Banana,Cherry"'), nebo vlastní vzorec.
formula2strHorní mez pro BETWEEN a NOT_BETWEEN operátory.
alert_styleDataValidationAlertStyleJak Excel reaguje na neplatný vstup (STOP, WARNING, nebo INFORMATION).
show_error_messageboolTrue pro zobrazení dialogu s chybovou zprávou při neplatném vstupu.
error_titlestrNázev dialogu s chybou (max 32 znaků).
error_messagestrText dialogu s chybou (max 225 znaků).
show_input_messageboolTrue pro zobrazení výzvy k zadání, když je buňka vybrána.
input_titlestrNázev výzvy k zadání (max 32 znaků).
input_messagestrText výzvy k zadání (max 255 znaků).
allow_blankboolTrue pro povolení prázdných (prázdných) buněk, aniž by se vyvolala chyba.
show_dropdownboolTrue pro zobrazení šipky rozbalovacího seznamu u validací seznamu.
ime_modeDataValidationImeModeRežim IME pro vkládání východoasijského textu.

Enumerations

copy 

validation.copy() -> DataValidation

Vrací hlubokou kopii tohoto pravidla ověřování.

DataValidationCollection

DataValidationCollection je přístupný jako ws.data_validations. Spravuje všechna validační pravidla v listu.

Enumerations

add 

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

Vytvoří a zaregistruje nové validační pravidlo v jednom volání. Vrací vytvořený DataValidation objekt.

add_validation 

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

Zaregistruje předkonfigurovaný DataValidation objekt. Vrací stejný objekt.

remove 

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

Odstraní validační pravidlo podle reference. Vrací True pokud byl pravidlo nalezeno a odstraněno.

remove_at 

ws.data_validations.remove_at(index: int)

Odstraní validační pravidlo na zadaném indexu počítaném od nuly.

remove_by_range 

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

Odstraní všechna validace, jejichž sqref překrývá zadaný rozsah. Vrací počet odstraněných pravidel.

clear 

ws.data_validations.clear()

Odstraní všechna validační pravidla z listu.

get_validation 

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

Vrací validační pravidlo, které se vztahuje k zadané referenci buňky (např.,)., "B5"), nebo None pokud žádný neplatí.

Vlastnosti a iterace

EnumerationsEnumerations
countPočet validačních pravidel v tomto listu (pouze pro čtení).
disable_promptsbool — Nastavit na True pro potlačení všech výzev vstupních zpráv globálně.
__len__()Enumerations count.
__iter__()Prochází všechny DataValidation objekty.
__getitem__(index)Vrací DataValidation na nulovém indexu index.

Enumerations

Validace rozbalovacího seznamu 

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

Validace číselného rozsahu 

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

Viz také

 Čeština