Aspose.Cells FOSS
Python
DataValidation

DataValidation — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss podporuje pridávanie pravidiel overovania údajov do rozsahov buniek. Pravidlá overovania sa spravujú prostredníctvom ws.data_validations, a DataValidationCollection pripojený ku každému Worksheet.

ImageRenderOptions: aspose.cells_foss

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

DataValidationType

DataValidationType je IntEnum identifikujúci typ obmedzenia, ktoré sa má použiť.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
NONE0Žiadne obmedzenie overovania.
WHOLE_NUMBER1Akceptuje iba celé čísla.
DECIMAL2Akceptuje desatinné čísla.
LIST3Akceptuje hodnoty z rozbaľovacieho zoznamu.
DATE4Akceptuje iba dátumové hodnoty.
TIME5Akceptuje iba časové hodnoty.
TEXT_LENGTH6Overuje podľa dĺžky textu.
CUSTOM7Overuje pomocou vlastného vzorca.

DataValidationOperator

DataValidationOperator je IntEnum špecifikujúci porovnávací operátor používaný s číselnými/dátumovými/časovými/dĺžkovými obmedzeniami.

ImageRenderOptionsImageRenderOptions
BETWEEN0
NOT_BETWEEN1
EQUAL2
NOT_EQUAL3
GREATER_THAN4
LESS_THAN5
GREATER_THAN_OR_EQUAL6
LESS_THAN_OR_EQUAL7

DataValidationAlertStyle

DataValidationAlertStyle je IntEnum riadenie toho, ako Excel reaguje pri zadávaní neplatných údajov.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
STOP0Odmietne zadanie a zobrazí chybový dialóg (predvolené).
WARNING1Zobrazí varovanie, ale povolí zadanie.
INFORMATION2Zobrazí informačnú správu, ale vždy povolí zadanie.

DataValidationImeMode

DataValidationImeMode je IntEnum riadi režim IME (Input Method Editor) pre zadávanie východoázijského textu.

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

DataValidation

A DataValidation objekt popisuje jedno validačné pravidlo a rozsah buniek (sqref) na ktoré sa vzťahuje.

ImageRenderOptions 

DataValidation(sqref=None)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
sqref`strNone`

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sqrefstrRozsah buniek pre toto pravidlo (napr., "B2:B100").
typeDataValidationTypeTyp validácie (celé číslo, desatinné, zoznam, dátum, čas, dĺžka textu alebo vlastný).
operatorDataValidationOperatorPorovnávací operátor aplikovaný na formula1 (a formula2 pre BETWEEN/NOT_BETWEEN).
formula1strDolná hranica, zdroj zoznamu (napr., '"Apple,Banana,Cherry"'), alebo vlastný vzorec.
formula2strHorná hranica pre BETWEEN a NOT_BETWEEN operátory.
alert_styleDataValidationAlertStyleAko Excel reaguje na neplatný vstup (STOP, WARNING, alebo INFORMATION).
show_error_messageboolTrue zobraziť dialógové okno s chybovou správou pri neplatnom vstupnom údaji.
error_titlestrNázov chybového dialógu (max 32 znakov).
error_messagestrTelo chybového dialógu (max 225 znakov).
show_input_messageboolTrue zobraziť výzvu na zadanie vstupu, keď je bunka vybraná.
input_titlestrNázov výzvy na vstup (max 32 znakov).
input_messagestrTelo výzvy na vstup (max 255 znakov).
allow_blankboolTrue povoliť prázdne (nevyplnené) bunky bez spustenia chyby.
show_dropdownboolTrue zobraziť šípku rozbaľovacieho zoznamu pre overovanie zoznamov.
ime_modeDataValidationImeModeRežim IME pre vkladanie východoázijského textu.

ImageRenderOptions

copy 

validation.copy() -> DataValidation

Vráti hlbokú kópiu tohto pravidla overovania.

DataValidationCollection

DataValidationCollection sa pristupuje ako ws.data_validations. Spravuje všetky pravidlá overovania v hárku.

ImageRenderOptions

add 

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

Vytvorí a zaregistruje nové pravidlo overovania v jednom volaní. Vráti vytvorený DataValidation objekt.

add_validation 

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

Zaregistruje predkonfigurovaný DataValidation objekt. Vráti rovnaký objekt.

remove 

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

Odstráni pravidlo overovania podľa referencie. Vráti True ak bolo pravidlo nájdené a odstránené.

remove_at 

ws.data_validations.remove_at(index: int)

Odstráni pravidlo overovania na zadanom indexe začínajúcom od nuly.

remove_by_range 

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

Odstráni všetky validácie, ktorých sqref prekrýva zadaný rozsah. Vráti počet odstránených pravidiel.

clear 

ws.data_validations.clear()

Odstráni všetky pravidlá overovania z pracovného hárku.

get_validation 

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

Vráti validačné pravidlo, ktoré sa vzťahuje na daný odkaz na bunku (napr., "B5"), alebo None ak žiadny neplatí.

Vlastnosti a iterácia

ImageRenderOptionsImageRenderOptions
countPočet validačných pravidiel v tomto hárku (iba na čítanie).
disable_promptsbool — Nastaviť na True na globálne potlačenie všetkých výziev vstupných správ.
__len__()ImageRenderOptions count.
__iter__()Iteruje cez všetky DataValidation objekty.
__getitem__(index)Vráti DataValidation na nulovo založenom index.

ImageRenderOptions

Validácia rozbaľovacieho zoznamu 

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

Validácia čí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")

Pozri tiež

 Slovenčina