Cells
Python
DataValidation

DataValidation — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss palaiko duomenų tikrinimo taisyklių pridėjimą prie langelių diapazonų. Tikrinimo taisyklės valdomos per ws.data_validations, a DataValidationCollection priskiriama kiekvienam Worksheet.

ImageRenderOptions: aspose.cells_foss

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

DataValidationType

DataValidationType yra IntEnum nurodantis taikomo apribojimo tipą.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
NONE0Nėra validacijos apribojimo.
WHOLE_NUMBER1Priima tik sveikuosius skaičius.
DECIMAL2Priima dešimtainius skaičius.
LIST3Priima reikšmes iš išskleidžiamojo sąrašo.
DATE4Priima tik datos reikšmes.
TIME5Priima tik laiko reikšmes.
TEXT_LENGTH6Patikrina pagal teksto ilgį.
CUSTOM7Patikrina naudojant pasirinktą formulę.

DataValidationOperator

DataValidationOperator yra IntEnum nurodant palyginimo operatorių, naudojamą su skaitiniais / datos / laiko / ilgio apribojimais.

ImageRenderOptionsImageRenderOptions
BETWEEN0
NOT_BETWEEN1
EQUAL2
NOT_EQUAL3
GREATER_THAN4
LESS_THAN5
GREATER_THAN_OR_EQUAL6
LESS_THAN_OR_EQUAL7

DataValidationAlertStyle

DataValidationAlertStyle yra IntEnum valdyti, kaip „Excel“ reaguoja, kai įvedami neteisingi duomenys.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
STOP0Atmeta įrašą ir rodo klaidos dialogą (numatytasis).
WARNING1Rodo įspėjimą, bet leidžia įrašą.
INFORMATION2Rodo informacinę žinutę, bet visada leidžia įrašą.

DataValidationImeMode

DataValidationImeMode yra IntEnum valdo IME (Input Method Editor) režimą rytų Azijos teksto įvedimui.

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

DataValidation

A DataValidation objektas aprašo vieną patikrinimo taisyklę ir langelių diapazoną (sqref) kuriam ji taikoma.

ImageRenderOptions 

DataValidation(sqref=None)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
sqref`strNone`

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sqrefstrLąstelių diapazonas šiai taisyklei (pvz., "B2:B100").
typeDataValidationTypePatikrinimo tipas (sveikasis skaičius, dešimtainis, sąrašas, data, laikas, teksto ilgis arba pasirinktinė).
operatorDataValidationOperatorPalyginimo operatorius, taikomas formula1 (ir formula2 skirta BETWEEN/NOT_BETWEEN).
formula1strApatinė riba, sąrašo šaltinis (pvz., '"Apple,Banana,Cherry"'), arba pasirinktinė formulė.
formula2strViršutinė riba, skirta BETWEEN ir NOT_BETWEEN operatoriai.
alert_styleDataValidationAlertStyleKaip Excel reaguoja į neteisingą įvestį (STOP, WARNING, arba INFORMATION).
show_error_messageboolTrue rodyti klaidos pranešimo dialogą, kai įvestis neteisinga.
error_titlestrKlaidos dialogo pavadinimas (maks. 32 simboliai).
error_messagestrKlaidos dialogo turinys (maks. 225 simboliai).
show_input_messageboolTrue rodyti įvesties kvietimo pranešimą, kai pasirenkamas langelis.
input_titlestrĮvesties kvietimo pavadinimas (maks. 32 simboliai).
input_messagestrĮvesties užklausos turinys (maks. 255 simboliai).
allow_blankboolTrue leidžiant tuščius (nepildytus) langelius nesukeliant klaidos.
show_dropdownboolTrue rodyti išskleidžiamą rodyklę sąrašo patikrinimams.
ime_modeDataValidationImeModeIME režimas rytų Azijos teksto įvedimui.

ImageRenderOptions

copy 

validation.copy() -> DataValidation

Returns a deep copy of this validation rule.

DataValidationCollection

DataValidationCollection prieinama kaip ws.data_validations. Jis valdo visas patikrinimo taisykles darbalapyje.

ImageRenderOptions

add 

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

Sukuria ir registruoja naują patikrinimo taisyklę vienu iškvietimu. Grąžina sukurtą DataValidation objektą.

add_validation 

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

Registruoja iš anksto sukonfigūruotą DataValidation objektas. Grąžina tą patį objektą.

remove 

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

Pašalina validacijos taisyklę pagal nuorodą. Grąžina True jei taisyklė buvo rasta ir pašalinta.

remove_at 

ws.data_validations.remove_at(index: int)

Pašalina patvirtinimo taisyklę nurodytoje nulinio indekso vietoje.

remove_by_range 

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

Pašalina visas validacijas, kurių sqref persidengia su nurodytu diapazonu. Grąžina pašalintų taisyklių skaičių.

clear 

ws.data_validations.clear()

Pašalina visas patvirtinimo taisykles iš darbalapio.

get_validation 

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

Grąžina validacijos taisyklę, kuri taikoma nurodytai ląstelės nuorodai (pvz., "B5"), arba None jei nė viena netaikoma.

Savybės ir iteravimas

ImageRenderOptionsImageRenderOptions
countValidacijos taisyklių skaičius šiame darbalapyje (tik skaitymui).
disable_promptsbool — Nustatyti į True norint visuotiniškai slopinti visus įvesties pranešimų kvietimus.
__len__()ImageRenderOptions count.
__iter__()Iteruoja per visus DataValidation objektus.
__getitem__(index)Grąžina DataValidation nulio pagrindu index.

ImageRenderOptions

Išskleidžiamojo sąrašo patvirtinimas 

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

Skaitinės reikšmės intervalo patvirtinimas 

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

Žr. taip pat

 Lietuvių