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 המזהה את סוג ההגבלה ליישום.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
NONE | 0 | אין הגבלת אימות. |
WHOLE_NUMBER | 1 | מקבל רק מספרים שלמים. |
DECIMAL | 2 | מקבל מספרים עשרוניים. |
LIST | 3 | מקבל ערכים מרשימת נפתחת. |
DATE | 4 | מקבל רק ערכי תאריך. |
TIME | 5 | מקבל רק ערכי זמן. |
TEXT_LENGTH | 6 | מאמת לפי אורך הטקסט. |
CUSTOM | 7 | מאמת באמצעות נוסחה מותאמת. |
DataValidationOperator
DataValidationOperator הוא IntEnum המפרט את אופרטור ההשוואה המשמש עם הגבלות מספריות/תאריך/זמן/אורך.
| ColladaSaveOptions | ColladaSaveOptions |
|---|---|
BETWEEN | 0 |
NOT_BETWEEN | 1 |
EQUAL | 2 |
NOT_EQUAL | 3 |
GREATER_THAN | 4 |
LESS_THAN | 5 |
GREATER_THAN_OR_EQUAL | 6 |
LESS_THAN_OR_EQUAL | 7 |
DataValidationAlertStyle
DataValidationAlertStyle הוא IntEnum בקרת האופן שבו Excel מגיב כאשר מוזנים נתונים לא תקינים.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
STOP | 0 | דוחה את ההזנה ומציג תיבת דו-שיח של שגיאה (ברירת מחדל). |
WARNING | 1 | מציג אזהרה אך מאפשר את ההזנה. |
INFORMATION | 2 | מציג הודעה מידעית אך תמיד מאפשר את ההזנה. |
DataValidationImeMode
DataValidationImeMode הוא IntEnum שולט במצב ה‑IME (Input Method Editor) עבור הקלדת טקסט במזרח אסייתי.
| ColladaSaveOptions | ColladaSaveOptions |
|---|---|
NO_CONTROL | 0 |
OFF | 1 |
ON | 2 |
DISABLED | 3 |
HIRAGANA | 4 |
FULL_KATAKANA | 5 |
HALF_KATAKANA | 6 |
FULL_ALPHA | 7 |
HALF_ALPHA | 8 |
FULL_HANGUL | 9 |
HALF_HANGUL | 10 |
DataValidation
א DataValidation העצם מתאר כלל אימות יחיד ואת טווח התאים (sqref) שהוא חל עליו.
ColladaSaveOptions
DataValidation(sqref=None)| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
sqref | `str | None` |
ColladaSaveOptions
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
sqref | str | טווח התאים עבור כלל זה (למשל,., "B2:B100"). |
type | DataValidationType | ) סוג האימות (מספר שלם, עשרוני, רשימה, תאריך, זמן, אורך טקסט, או מותאם אישית). |
operator | DataValidationOperator | אופרטור השוואה המיושם על formula1 (ו formula2 ל BETWEEN/NOT_BETWEEN). |
formula1 | str | גבול תחתון, מקור רשימה (למשל,., '"Apple,Banana,Cherry"'), או נוסחה מותאמת אישית. |
formula2 | str | גבול עליון עבור BETWEEN ו NOT_BETWEEN אופרטורים. |
alert_style | DataValidationAlertStyle | איך Excel מגיב לקלט לא תקין (STOP, WARNING, או INFORMATION). |
show_error_message | bool | True להציג את תיבת הדיאלוג של הודעת השגיאה בקלט לא תקין. |
error_title | str | כותרת תיבת הדיאלוג של השגיאה (עד 32 תווים). |
error_message | str | גוף תיבת הדיאלוג של השגיאה (עד 225 תווים). |
show_input_message | bool | True להציג הודעת בקשת קלט כאשר התא נבחר. |
input_title | str | כותרת בקשת הקלט (עד 32 תווים). |
input_message | str | גוף בקשת הקלט (עד 255 תווים). |
allow_blank | bool | True לאפשר תאים ריקים (empty) מבלי להפעיל את השגיאה. |
show_dropdown | bool | True להציג חץ נפתח עבור אימותי רשימה. |
ime_mode | DataValidationImeMode | מצב 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 אם אף אחד אינו חל.
מאפיינים וחזרה
| ColladaSaveOptions | ColladaSaveOptions |
|---|---|
count | מספר כללי האימות בגיליון העבודה הזה (קריאה בלבד). |
disable_prompts | bool — הגדר ל 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")