DataValidation

DataValidation — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss תומך בהוספת כללי אימות נתונים לטווחי תאים. כללי האימות מנוהלים באמצעות ws.data_validations, א DataValidationCollection מצורף לכל Worksheet.

ColladaSaveOptions: aspose.cells_foss

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

DataValidationType

DataValidationType הוא IntEnum המזהה את סוג ההגבלה ליישום.

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
NONE0אין הגבלת אימות.
WHOLE_NUMBER1מקבל רק מספרים שלמים.
DECIMAL2מקבל מספרים עשרוניים.
LIST3מקבל ערכים מרשימת נפתחת.
DATE4מקבל רק ערכי תאריך.
TIME5מקבל רק ערכי זמן.
TEXT_LENGTH6מאמת לפי אורך הטקסט.
CUSTOM7מאמת באמצעות נוסחה מותאמת.

DataValidationOperator

DataValidationOperator הוא IntEnum המפרט את אופרטור ההשוואה המשמש עם הגבלות מספריות/תאריך/זמן/אורך.

ColladaSaveOptionsColladaSaveOptions
BETWEEN0
NOT_BETWEEN1
EQUAL2
NOT_EQUAL3
GREATER_THAN4
LESS_THAN5
GREATER_THAN_OR_EQUAL6
LESS_THAN_OR_EQUAL7

DataValidationAlertStyle

DataValidationAlertStyle הוא IntEnum בקרת האופן שבו Excel מגיב כאשר מוזנים נתונים לא תקינים.

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
STOP0דוחה את ההזנה ומציג תיבת דו-שיח של שגיאה (ברירת מחדל).
WARNING1מציג אזהרה אך מאפשר את ההזנה.
INFORMATION2מציג הודעה מידעית אך תמיד מאפשר את ההזנה.

DataValidationImeMode

DataValidationImeMode הוא IntEnum שולט במצב ה‑IME (Input Method Editor) עבור הקלדת טקסט במזרח אסייתי.

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

DataValidation

א DataValidation העצם מתאר כלל אימות יחיד ואת טווח התאים (sqref) שהוא חל עליו.

ColladaSaveOptions

DataValidation(sqref=None)
ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
sqref`strNone`

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
sqrefstrטווח התאים עבור כלל זה (למשל,., "B2:B100").
typeDataValidationType) סוג האימות (מספר שלם, עשרוני, רשימה, תאריך, זמן, אורך טקסט, או מותאם אישית).
operatorDataValidationOperatorאופרטור השוואה המיושם על formula1formula2 ל BETWEEN/NOT_BETWEEN).
formula1strגבול תחתון, מקור רשימה (למשל,., '"Apple,Banana,Cherry"'), או נוסחה מותאמת אישית.
formula2strגבול עליון עבור BETWEEN ו NOT_BETWEEN אופרטורים.
alert_styleDataValidationAlertStyleאיך Excel מגיב לקלט לא תקין (STOP, WARNING, או INFORMATION).
show_error_messageboolTrue להציג את תיבת הדיאלוג של הודעת השגיאה בקלט לא תקין.
error_titlestrכותרת תיבת הדיאלוג של השגיאה (עד 32 תווים).
error_messagestrגוף תיבת הדיאלוג של השגיאה (עד 225 תווים).
show_input_messageboolTrue להציג הודעת בקשת קלט כאשר התא נבחר.
input_titlestrכותרת בקשת הקלט (עד 32 תווים).
input_messagestrגוף בקשת הקלט (עד 255 תווים).
allow_blankboolTrue לאפשר תאים ריקים (empty) מבלי להפעיל את השגיאה.
show_dropdownboolTrue להציג חץ נפתח עבור אימותי רשימה.
ime_modeDataValidationImeModeמצב IME לקלט טקסט מזרח אסייתי.

ColladaSaveOptions

copy

validation.copy() -> DataValidation

מחזיר עותק עמוק של כלל האימות הזה.


DataValidationCollection

DataValidationCollection נגיש כ ws.data_validations. הוא מנהל את כל חוקי האימות בגיליון עבודה.

ColladaSaveOptions

add

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

יוצר ורושם כלל אימות חדש בקריאה אחת. מחזיר את ה DataValidation אובייקט.

add_validation

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

רושם DataValidation אובייקט. מחזיר את אותו האובייקט.

remove

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

מסיר כלל אימות לפי הפנייה. מחזיר True אם הכלל נמצא והוסר.

remove_at

ws.data_validations.remove_at(index: int)

מסיר את כלל האימות באינדקס שמתחיל מאפס.

remove_by_range

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

מסיר את כל האימותים ש- sqref חופף את הטווח הנתון. מחזיר את מספר הכללים שהוסרו.

clear

ws.data_validations.clear()

מסיר את כל כללי האימות מהגיליון.

get_validation

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

מחזיר את כלל האימות שמיושם על הפנייה לתא הנתון (למשל,)., "B5"), או None אם אף אחד אינו חל.

מאפיינים וחזרה

ColladaSaveOptionsColladaSaveOptions
countמספר כללי האימות בגיליון העבודה הזה (קריאה בלבד).
disable_promptsbool — הגדר ל True כדי לדכא את כל הודעות הקלט באופן גלובלי.
__len__()ColladaSaveOptions count.
__iter__()חוזר על כל DataValidation אובייקטים.
__getitem__(index)מחזיר את DataValidation במיקום מבוסס-אפס index.

ColladaSaveOptions

אימות רשימת נפתחת

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

אימות טווח מספרי

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

ראה גם

 עברית