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 يحدد نوع القيد الذي سيتم تطبيقه.

EnumerationsEnumerationsEnumerations
NONE0لا يوجد قيد تحقق.
WHOLE_NUMBER1يقبل أعدادًا صحيحة فقط.
DECIMAL2يقبل أعدادًا عشرية.
LIST3يقبل القيم من قائمة منسدلة.
DATE4يقبل قيم تواريخ فقط.
TIME5يقبل قيم الوقت فقط.
TEXT_LENGTH6يتحقق من الصحة حسب طول النص.
CUSTOM7يتحقق من الصحة باستخدام صيغة مخصصة.

DataValidationOperator

DataValidationOperator هو IntEnum يحدد عامل المقارنة المستخدم مع قيود الأرقام/التواريخ/الأوقات/الطول.

EnumerationsEnumerations
BETWEEN0
NOT_BETWEEN1
EQUAL2
NOT_EQUAL3
GREATER_THAN4
LESS_THAN5
GREATER_THAN_OR_EQUAL6
LESS_THAN_OR_EQUAL7

DataValidationAlertStyle

DataValidationAlertStyle هو IntEnum يتحكم في كيفية استجابة Excel عندما يتم إدخال بيانات غير صالحة.

EnumerationsEnumerationsEnumerations
STOP0يرفض الإدخال ويظهر حوار خطأ (الافتراضي).
WARNING1يعرض تحذيرًا لكنه يسمح بالإدخال.
INFORMATION2يعرض رسالة معلوماتية لكنه يسمح دائمًا بالإدخال.

DataValidationImeMode

DataValidationImeMode هو IntEnum يتحكم في وضع IME (محرر طريقة الإدخال) لإدخال النصوص الآسيوية الشرقية.

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

DataValidation

أ DataValidation يصف كائن قاعدة تحقق واحدة ونطاق الخلايا (sqref) التي ينطبق عليها.

Enumerations

DataValidation(sqref=None)
EnumerationsEnumerationsEnumerations
sqref`strNone`

Enumerations

EnumerationsEnumerationsEnumerations
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عنوان مربع حوار الخطأ (max 32 characters).
error_messagestrنص مربع حوار الخطأ (max 225 characters).
show_input_messageboolTrue عرض رسالة موجه الإدخال عند تحديد الخلية.
input_titlestrعنوان موجه الإدخال (max 32 characters).
input_messagestrنص موجه الإدخال (max 255 characters).
allow_blankboolTrue السماح بالخلايا الفارغة (الخالية) دون تفعيل الخطأ.
show_dropdownboolTrue عرض سهم القائمة المنسدلة للتحقق من القوائم.
ime_modeDataValidationImeModeوضع 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 إذا لم ينطبق أي منها.

الخصائص والتكرار

EnumerationsEnumerations
countعدد قواعد التحقق في هذه ورقة العمل (للقراءة فقط).
disable_promptsbool — اضبط إلى 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")

انظر أيضًا

 العربية