DataValidation

DataValidation — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss tukee datavalidaatiosääntöjen lisäämistä solualueisiin. Validaatiosäännöt hallitaan ws.data_validations, a DataValidationCollection liitetty kuhunkin Worksheet.

ColladaSaveOptions: aspose.cells_foss

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

DataValidationType

DataValidationType on IntEnum joka tunnistaa sovellettavan rajoitustyypin.

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
NONE0Ei validointirajoitusta.
WHOLE_NUMBER1Hyväksyy vain kokonaislukuja.
DECIMAL2Hyväksyy desimaalilukuja.
LIST3Hyväksyy arvoja avattavasta valikosta.
DATE4Hyväksyy vain päivämääräarvoja.
TIME5Hyväksyy vain aika-arvoja.
TEXT_LENGTH6Vahvistaa tekstin pituuden perusteella.
CUSTOM7Vahvistaa käyttäen mukautettua kaavaa.

DataValidationOperator

DataValidationOperator on IntEnum joka määrittää numeeristen/päivämäärä-/aika-/pituusrajoitusten vertailuoperaattorin.

ColladaSaveOptionsColladaSaveOptions
BETWEEN0
NOT_BETWEEN1
EQUAL2
NOT_EQUAL3
GREATER_THAN4
LESS_THAN5
GREATER_THAN_OR_EQUAL6
LESS_THAN_OR_EQUAL7

DataValidationAlertStyle

DataValidationAlertStyle on IntEnum ohjaa sitä, miten Excel reagoi, kun virheellistä dataa syötetään.

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
STOP0Hylkää syötteen ja näyttää virheikkunan (oletus).
WARNING1Näyttää varoituksen, mutta sallii syötteen.
INFORMATION2Näyttää tiedotusviestin, mutta sallii syötteen aina.

DataValidationImeMode

DataValidationImeMode on IntEnum ohjaa IME (Input Method Editor) -tilaa itäaasialaisessa tekstinsyötössä.

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

DataValidation

Yksi DataValidation objekti kuvaa yhtä validointisääntöä ja solujen aluetta (sqref) johon se sovelletaan.

ColladaSaveOptions

DataValidation(sqref=None)
ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
sqref`strNone`

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
sqrefstrSolujen alue tälle säännölle (esim., "B2:B100").
typeDataValidationType) Validointityyppi (kokonaisluku, desimaali, luettelo, päivämäärä, aika, tekstin pituus tai mukautettu).
operatorDataValidationOperatorVertailuoperaattori, joka kohdistetaan formula1 (ja formula2 kohteelle BETWEEN/NOT_BETWEEN).
formula1strAlaraja, luettelolähde (esim., '"Apple,Banana,Cherry"'), tai mukautettu kaava.
formula2strYläraja kohteelle BETWEEN ja NOT_BETWEEN operaattorit.
alert_styleDataValidationAlertStyleKuinka Excel reagoi virheelliseen syötteeseen (STOP, WARNING, tai INFORMATION).
show_error_messageboolTrue näyttämään virheilmoitusikkunan virheellisessä syötteessä.
error_titlestrVirheikkunan otsikko (enintään 32 merkkiä).
error_messagestrVirheikkunan sisältö (enintään 225 merkkiä).
show_input_messageboolTrue näyttämään syötekehotusviestin, kun solu on valittuna.
input_titlestrSyötekehotuksen otsikko (enintään 32 merkkiä).
input_messagestrSyötekehotuksen sisältö (enintään 255 merkkiä).
allow_blankboolTrue sallii tyhjät (tyhjä) solut ilman virheen laukaamista.
show_dropdownboolTrue näyttämään pudotusvalikon nuolen luettelotarkistuksissa.
ime_modeDataValidationImeModeIME-tila Itäaasialaiselle tekstinsyötölle.

ColladaSaveOptions

copy

validation.copy() -> DataValidation

Palauttaa syväkopion tästä validointisäännöstä.


DataValidationCollection

DataValidationCollection on käytettävissä muodossa ws.data_validations. Se hallitsee kaikkia tarkistussääntöjä laskentataulukossa.

ColladaSaveOptions

add

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

Luo ja rekisteröi uuden tarkistussäännön yhdessä kutsussa. Palauttaa luodun DataValidation objektin.

add_validation

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

Rekisteröi ennalta määritetyn DataValidation objektin. Palauttaa saman objektin.

remove

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

Poistaa tarkistussäännön viitteellä. Palauttaa True jos sääntö löytyi ja poistettiin.

remove_at

ws.data_validations.remove_at(index: int)

Poistaa validointisäännön annetussa nollapohjaisessa indeksissä.

remove_by_range

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

Poistaa kaikki validoinnit, joiden sqref yltää annetulle alueelle. Palauttaa poistettujen sääntöjen määrän.

clear

ws.data_validations.clear()

Poistaa kaikki validointisäännöt työkirjan taulukosta.

get_validation

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

Palauttaa validointisäännön, joka koskee annettua solureferenssiä (esim., "B5"), tai None jos mikään ei koske.

Ominaisuudet ja iteraatio

ColladaSaveOptionsColladaSaveOptions
countValidaatiosääntöjen määrä tässä laskentataulukossa (vain luku).
disable_promptsbool — Aseta True estääksesi kaikki syöteviestikehotteet globaalisti.
__len__()ColladaSaveOptions count.
__iter__()Iteroi kaikkia DataValidation objektia.
__getitem__(index)Palauttaa DataValidation nollapohjainen index.

ColladaSaveOptions

Alasvetovalikon validointi

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

Numeraalinen välivalidointi

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

Katso myös

 Suomi