Aspose.Cells FOSS
Python
DataValidation

DataValidation — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss támogatja adatérvényesítési szabályok hozzáadását a cellatartományokhoz. Az adatérvényesítési szabályokat a ws.data_validations, egy DataValidationCollection minden egyeshez csatolt Worksheet.

ImageRenderOptions: aspose.cells_foss

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

DataValidationType

DataValidationType egy IntEnum amely meghatározza az alkalmazandó korlátozás típusát.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
NONE0Nincs adatérvényesítési korlátozás.
WHOLE_NUMBER1Csak egész számokat fogad el.
DECIMAL2Tört számokat fogad el.
LIST3Értékeket fogad el egy legördülő listából.
DATE4Csak dátumértékeket fogad el.
TIME5Csak időértékeket fogad el.
TEXT_LENGTH6Szöveghossz alapján ellenőriz.
CUSTOM7Egyéni képlet használatával ellenőriz.

DataValidationOperator

DataValidationOperator egy IntEnum amely meghatározza a numerikus/dátum/idő/hossz korlátozásoknál használt összehasonlító operátort.

ImageRenderOptionsImageRenderOptions
BETWEEN0
NOT_BETWEEN1
EQUAL2
NOT_EQUAL3
GREATER_THAN4
LESS_THAN5
GREATER_THAN_OR_EQUAL6
LESS_THAN_OR_EQUAL7

DataValidationAlertStyle

DataValidationAlertStyle egy IntEnum az Excel reakciójának szabályozása, amikor érvénytelen adatot adnak meg.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
STOP0Elutasítja a bevitelt, és hibapárbeszédet jelenít meg (alapértelmezett).
WARNING1Figyelmeztetést jelenít meg, de engedélyezi a bevitelt.
INFORMATION2Információs üzenetet jelenít meg, de mindig engedélyezi a bevitelt.

DataValidationImeMode

DataValidationImeMode egy IntEnum az IME (Input Method Editor) módjának vezérlése kelet-ázsiai szövegbevitelhez.

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

DataValidation

Egy DataValidation objektum leír egyetlen érvényesítési szabályt és a cellatartományt (sqref) amelyre vonatkozik.

ImageRenderOptions 

DataValidation(sqref=None)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
sqref`strNone`

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sqrefstrA cellatartomány ehhez a szabályhoz (pl., "B2:B100").
typeDataValidationTypeÉrvényesítési típus (egész szám, tizedes, lista, dátum, idő, szöveghossz, vagy egyéni).
operatorDataValidationOperatorÖsszehasonlító operátor alkalmazva a formula1 (és formula2 a BETWEEN/NOT_BETWEEN).
formula1strAlsó határ, lista forrás (pl., '"Apple,Banana,Cherry"'), vagy egyéni képlet.
formula2strFelső határ a BETWEEN és NOT_BETWEEN operátorok.
alert_styleDataValidationAlertStyleHogyan reagál az Excel a hibás bemenetre (STOP, WARNING, vagy INFORMATION).
show_error_messageboolTrue a hibajelzés párbeszédablak megjelenítéséhez érvénytelen bemenet esetén.
error_titlestrA hibaablak címe (max. 32 karakter).
error_messagestrA hibaablak szövege (max. 225 karakter).
show_input_messageboolTrue bemeneti felszólítás üzenet megjelenítéséhez, amikor a cella ki van választva.
input_titlestrA bemeneti felszólítás címe (max. 32 karakter).
input_messagestrA bemeneti felszólítás szövege (max. 255 karakter).
allow_blankboolTrue üres (blank) cellák engedélyezéséhez a hiba kiváltása nélkül.
show_dropdownboolTrue legördülő nyíl megjelenítéséhez listával történő ellenőrzésnél.
ime_modeDataValidationImeModeIME mód kelet-ázsiai szövegbevitelhez.

ImageRenderOptions

copy 

validation.copy() -> DataValidation

Visszaadja ennek az érvényesítési szabálynak a mélymásolatát.

DataValidationCollection

DataValidationCollection hozzáférhető mint ws.data_validations. Kezeli a munkalapon lévő összes ellenőrzési szabályt.

ImageRenderOptions

add 

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

Létrehozza és regisztrálja az új ellenőrzési szabályt egy hívásban. Visszaadja a létrehozott DataValidation objektumot.

add_validation 

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

Regisztrál egy előre konfigurált DataValidation objektumot. Visszaadja ugyanazt az objektumot.

remove 

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

Eltávolít egy ellenőrzési szabályt referenciával. Visszaadja True ha a szabály megtalálásra és eltávolításra került.

remove_at 

ws.data_validations.remove_at(index: int)

Eltávolítja az adott, nullától induló indexen lévő érvényesítési szabályt.

remove_by_range 

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

Eltávolítja az összes érvényesítést, amelynek sqref átfed a megadott tartományt. Visszaadja az eltávolított szabályok számát.

clear 

ws.data_validations.clear()

Eltávolítja az összes érvényesítési szabályt a munkalapról.

get_validation 

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

Visszaadja azt az érvényesítési szabályt, amely az adott cellahivatkozásra (például) vonatkozik.., "B5"), vagy None ha egyik sem érvényes.

Tulajdonságok és iteráció

ImageRenderOptionsImageRenderOptions
countA munkalapon lévő érvényesítési szabályok száma (csak olvasható).
disable_promptsbool — Állítsa be True az összes bemeneti üzenet felkérést globálisan elnyomja.
__len__()ImageRenderOptions count.
__iter__()Végigiterál az összes DataValidation objektumon.
__getitem__(index)Visszaadja a DataValidation nulla-alapú index.

ImageRenderOptions

Legördülő lista érvényesítés 

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

Számérték-tartomány érvényesítés 

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

Lásd még

 Magyar