| الموضوع السابق | الموضوع التالي |
الغرض
عرض نافذة حوار لإدخال اسم المستخدم و كلمة المرور للدخول إلى برنامج.
الصيغة
function UserLogIn(var UserName, Password: string; ACaption: string = 'الدخول إلى البرنامج'; AllowEmptyName: Boolean = False; AllowEmptyPassword: Boolean = False; MaxNameLen: Integer = 0; MaxPasswordLen: Integer = 0): Boolean;
function UserLogIn(UserName, Password: string; ShowName: Boolean = True; TryCount: Integer = 0; ACaption: string = 'الدخول إلى البرنامج'; AllowEmptyName: Boolean = False; AllowEmptyPassword: Boolean = False; MaxNameLen: Integer = 0; MaxPasswordLen: Integer = 0): Boolean;
الوسائط (Parameters)
| UserName | اسم المستخدم. يجب أن يكون وسيطاً متغيراً (var) في الصورة الأولى من الدالة. | |
| Password | كلمة المرور. يجب أن تكون وسيطاً متغيراً (var) في الصورة الأولى من الدالة. | |
| ACaption | بارامتر اختياري يحدد عنوان نافذة الحوار. الافتراضي هو "الدخول إلى البرنامج". | |
| AllowEmptyName | بارامتر اختياري يحدد ما إذا كان من الممكن اعتبار النص الفارغ (Empty String) إدخالاً مقبولاً كاسم للمستخدم. القيمة الافتراضية هي False و تعني أنه لا يمكن قبول النص الفارغ كاسم للمستخدم. | |
| AllowEmptyPassword | بارامتر اختياري يحدد ما إذا كان من الممكن اعتبار النص الفارغ (Empty String) إدخالاً مقبولاً ككلمة مرور. القيمة الافتراضية هي False و تعني أنه لا يمكن قبول النص الفارغ ككلمة مرور. | |
| MaxNameLen | بارامتر اختياري يحدد الحد الأقصى لطول اسم المستخدم. القيمة الافتراضية هي 0 و تعني أن طول اسم المستخدم غير محدود. | |
| MaxPasswordLen | بارامتر اختياري يحدد الحد الأقصى لطول كلمة المرور. القيمة الافتراضية هي 0 و تعني أن طول كلمة المرور غير محدود. | |
| ShowName | في الصيغة الثانية للدالة. بارامتر اختياري يحدد ما إذا سيتم إظهار اسم المستخدم (المحدد في البارامتر UserName) في الخانة الخاصة بالاسم عند عرض نافذة الحوار. القيمة الافتراضية هي True و تعني أنه سيتم عرض اسم المستخدم. | |
| TryCount | في الصيغة الثانية للدالة. بارامتر اختياري يحدد عدد المرات المسموح بها للمستخدم ليحاول إدخال الاسم و كلمة المرور الصحيحين. القيمة الافتراضية هي 0 و تعني أن عدد المحاولات غير محدود. |
الشرح
الصيغة الأولى من الدالة تعرض نافذة حوار عادية. إذا كتب المستخد الاسم و كلمة المرور ثم نقر على الزر "موافق" فإن الدالة تعيد True و تخزن الاسم في البارامتر UserName و تخزن كلمة المرور في البارامتر Password. أما إذا نقر المستخدم على الزر "إلغاء الأمر" فإن الدالة تعيد False.
أما الصيغة الثانية من الدالة فإنها تعرض نافذة كاملة الوظائف. تحتوي النافذة على إجراء يقوم بمقارنة الاسم الذي يكتبه المستخدم مع الاسم المحدد في البارامتر UserName و مقارنة كلمة المرور التي يكتبها المستخدم مع كلمة المرور المحددة في البارامتر Password (لذلك يجب أن يحتوي البارامتران UserName و Password على الاسم و كلمة المرور الفعليين اللذين ستتم المقارنة بهما). إذا تطابقت إدخالات المستخدم مع كل من البارامترين UserName و Password فإن الدالة تعيد True و تغلق النافذة. و إذا لم تكن الإدخالات مطابقة للمطلوب فإن النافذة تعرض رسالة تنبيه و تبقى مفتوحة إذا لم يستنفد المستخدم عدد مرات المحاولات (المحدد في البارامتر TryCount). إذا استنفد المستخدم عدد مرات المحاولات المحدد في البارامتر TryCount دون أن يدخل الاسم و كلمة المرور الصحيحين فإن النافذة تعرض رسالة اعتذار ثم تغلق النافذة، و الدالة ستعيد False. إذا نقر المستخدم على الزر "إلغاء الأمر" فإن الدالة تعيد False.
أخيراً، إذا كانت قيمة البارامتر TryCount هي الصفر (أي أن عدد المحاولات غير محدود) فإن النافذة لا تغلق إلا إذا أدخل المستخدم الاسم و كلمة المرور الصحيحين (الدالة تعيد True) أو نقر الزر "إلغاء الأمر" (الدالة تعيد False).
أعلى الصفحة
| الموضوع السابق | الموضوع التالي |