DataValidation — Aspose.Cells FOSS for Python API Reference
يدعم aspose-cells-foss إضافة قواعد التحقق من البيانات إلى نطاقات الخلايا. تُدار قواعد التحقق من البيانات من خلال ws.data_validations, أ DataValidationCollection مرفق لكل Worksheet.
Enumerations: aspose.cells_foss
from aspose.cells_foss import (
DataValidationType, DataValidationOperator,
DataValidationAlertStyle, DataValidationImeMode,
DataValidation, DataValidationCollection,
)DataValidationType
DataValidationType هو IntEnum يحدد نوع القيد الذي سيتم تطبيقه.
| Enumerations | Enumerations | Enumerations |
|---|---|---|
NONE | 0 | لا يوجد قيد تحقق. |
WHOLE_NUMBER | 1 | يقبل أعدادًا صحيحة فقط. |
DECIMAL | 2 | يقبل أعدادًا عشرية. |
LIST | 3 | يقبل القيم من قائمة منسدلة. |
DATE | 4 | يقبل قيم تواريخ فقط. |
TIME | 5 | يقبل قيم الوقت فقط. |
TEXT_LENGTH | 6 | يتحقق من الصحة حسب طول النص. |
CUSTOM | 7 | يتحقق من الصحة باستخدام صيغة مخصصة. |
DataValidationOperator
DataValidationOperator هو IntEnum يحدد عامل المقارنة المستخدم مع قيود الأرقام/التواريخ/الأوقات/الطول.
| Enumerations | Enumerations |
|---|---|
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 عندما يتم إدخال بيانات غير صالحة.
| Enumerations | Enumerations | Enumerations |
|---|---|---|
STOP | 0 | يرفض الإدخال ويظهر حوار خطأ (الافتراضي). |
WARNING | 1 | يعرض تحذيرًا لكنه يسمح بالإدخال. |
INFORMATION | 2 | يعرض رسالة معلوماتية لكنه يسمح دائمًا بالإدخال. |
DataValidationImeMode
DataValidationImeMode هو IntEnum يتحكم في وضع IME (محرر طريقة الإدخال) لإدخال النصوص الآسيوية الشرقية.
| Enumerations | Enumerations |
|---|---|
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) التي ينطبق عليها.
Enumerations
DataValidation(sqref=None)| Enumerations | Enumerations | Enumerations |
|---|---|---|
sqref | `str | None` |
Enumerations
| Enumerations | Enumerations | Enumerations |
|---|---|---|
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 | عنوان مربع حوار الخطأ (max 32 characters). |
error_message | str | نص مربع حوار الخطأ (max 225 characters). |
show_input_message | bool | True عرض رسالة موجه الإدخال عند تحديد الخلية. |
input_title | str | عنوان موجه الإدخال (max 32 characters). |
input_message | str | نص موجه الإدخال (max 255 characters). |
allow_blank | bool | True السماح بالخلايا الفارغة (الخالية) دون تفعيل الخطأ. |
show_dropdown | bool | True عرض سهم القائمة المنسدلة للتحقق من القوائم. |
ime_mode | DataValidationImeMode | وضع IME لإدخال النصوص الآسيوية الشرقية. |
Enumerations
copy
validation.copy() -> DataValidationيعيد نسخة عميقة من قاعدة التحقق هذه.
DataValidationCollection
DataValidationCollection يتم الوصول إليه كـ ws.data_validations. يدير جميع قواعد التحقق في ورقة العمل.
Enumerations
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 إذا لم ينطبق أي منها.
الخصائص والتكرار
| Enumerations | Enumerations |
|---|---|
count | عدد قواعد التحقق في هذه ورقة العمل (للقراءة فقط). |
disable_prompts | bool — اضبط إلى True لقمع جميع نوافذ رسائل الإدخال عالمياً. |
__len__() | Enumerations count. |
__iter__() | يتكرر على جميع DataValidation الكائنات. |
__getitem__(index) | يُرجع الـ DataValidation عند الصفرية index. |
Enumerations
التحقق من القائمة المنسدلة
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")