Cells
Python
DataValidation

DataValidation — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss atbalsta datu validācijas noteikumu pievienošanu šūnu diapazoniem. Validācijas noteikumi tiek pārvaldīti caur ws.data_validations, a DataValidationCollection pievienots katram Worksheet.

SaveOptions: aspose.cells_foss

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

DataValidationType

DataValidationType ir IntEnum identificē lietojamā ierobežojuma veidu.

SaveOptionsSaveOptionsSaveOptions
NONE0Nav validācijas ierobežojuma.
WHOLE_NUMBER1Pieņem tikai veselos skaitļus.
DECIMAL2Pieņem decimālus skaitļus.
LIST3Pieņem vērtības no nolaižamā saraksta.
DATE4Pieņem tikai datumu vērtības.
TIME5Pieņem tikai laika vērtības.
TEXT_LENGTH6Validē pēc teksta garuma.
CUSTOM7Validē, izmantojot pielāgotu formulu.

DataValidationOperator

DataValidationOperator ir IntEnum norādot salīdzināšanas operatoru, ko izmanto ar skaitiskajiem/datuma/laika/garuma ierobežojumiem.

SaveOptionsSaveOptions
BETWEEN0
NOT_BETWEEN1
EQUAL2
NOT_EQUAL3
GREATER_THAN4
LESS_THAN5
GREATER_THAN_OR_EQUAL6
LESS_THAN_OR_EQUAL7

DataValidationAlertStyle

DataValidationAlertStyle ir IntEnum kontrolējot, kā Excel reaģē, kad tiek ievadīti nederīgi dati.

SaveOptionsSaveOptionsSaveOptions
STOP0Noraida ierakstu un parāda kļūdas dialoglodziņu (noklusējums).
WARNING1Parāda brīdinājumu, bet ļauj ierakstu.
INFORMATION2Parāda informatīvu ziņojumu, bet vienmēr ļauj ierakstu.

DataValidationImeMode

DataValidationImeMode ir IntEnum kontrolē IME (Input Method Editor) režīmu austrumu Āzijas teksta ievadei.

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

DataValidation

A DataValidation objekts apraksta vienu validācijas noteikumu un šūnu diapazonu (sqref) tas attiecas uz.

SaveOptions 

DataValidation(sqref=None)
SaveOptionsSaveOptionsSaveOptions
sqref`strNone`

SaveOptions

SaveOptionsSaveOptionsSaveOptions
sqrefstrŠūnu diapazons šim noteikumam (piemēram,., "B2:B100").
typeDataValidationType) Validācijas veids (vesels skaitlis, decimāls, saraksts, datums, laiks, teksta garums vai pielāgots).
operatorDataValidationOperatorSalīdzināšanas operators, kas piemērots formula1 (un formula2 priekš BETWEEN/NOT_BETWEEN).
formula1strApakšējā robeža, saraksta avots (piemēram,., '"Apple,Banana,Cherry"'), vai pielāgota formula.
formula2strAugšējā robeža priekš BETWEEN un NOT_BETWEEN operatori.
alert_styleDataValidationAlertStyleKā Excel reaģē uz nederīgu ievadi (STOP, WARNING, vai INFORMATION).
show_error_messageboolTrue lai parādītu kļūdas ziņojuma dialoglodziņu nederīgā ievadē.
error_titlestrKļūdas dialoglodziņa virsraksts (maksimums 32 rakstzīmes).
error_messagestrKļūdas dialoglodziņa saturs (maksimums 225 rakstzīmes).
show_input_messageboolTrue lai parādītu ievades uzvednes ziņojumu, kad šūna ir izvēlēta.
input_titlestrIevades uzvednes virsraksts (maksimums 32 rakstzīmes).
input_messagestrIevades uzvednes saturs (maksimums 255 rakstzīmes).
allow_blankboolTrue lai atļautu tukšas (tukšas) šūnas, neizraisa kļūdu.
show_dropdownboolTrue lai parādītu nolaižamo bultiņu saraksta validācijām.
ime_modeDataValidationImeModeIME režīms austrumu Āzijas teksta ievadei.

SaveOptions

copy 

validation.copy() -> DataValidation

Atgriež dziļu kopiju šī validācijas noteikuma.

DataValidationCollection

DataValidationCollection tiek piekļūts kā ws.data_validations. Tas pārvalda visus validācijas noteikumus darblapā.

SaveOptions

add 

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

Izveido un reģistrē jaunu validācijas noteikumu vienā izsaukumā. Atgriež izveidoto DataValidation objekts.

add_validation 

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

Reģistrē iepriekš konfigurētu DataValidation objekts. Atgriež to pašu objektu.

remove 

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

Noņem validācijas noteikumu pēc atsauces. Atgriež True ja noteikums tika atrasts un noņemts.

remove_at 

ws.data_validations.remove_at(index: int)

Noņem validācijas noteikumu pie norādītā nulles bāzes indeksa.

remove_by_range 

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

Noņem visas validācijas, kuru sqref pārklā norādīto diapazonu. Atgriež noņemto noteikumu skaitu.

clear 

ws.data_validations.clear()

Noņem visus validācijas noteikumus no darblapas.

get_validation 

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

Atgriež validācijas noteikumu, kas attiecas uz norādīto šūnas atsauci (piemēram,., "B5"), vai None ja neviens neattiecas.

Īpašības un iterācija

SaveOptionsSaveOptions
countValidācijas noteikumu skaits šajā darblapā (tikai lasāms).
disable_promptsbool — Iestatīts uz True lai globāli nomācinātu visus ievades ziņojumu uzvedņus.
__len__()SaveOptions count.
__iter__()Iterē pār visiem DataValidation objektus.
__getitem__(index)Atgriež DataValidation ar nulles bāzētu index.

SaveOptions

Nolaižamā saraksta validācija 

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

Skaitliskā diapazona validācija 

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

Skatīt arī

 Latviešu