عنصر تحكم البطاقة في Power Apps
يوفر تجربة العرض والتحرير لحقل واحد لعنصر تحكم نموذج العرض أو نموذج التحرير.
الوصف
تعمل عناصر تحكم نموذج العرض و**نموذج التحرير** كحاويات لعرض السجلات الكاملة وعرضها. بإمكان كل حاوية أن تحتوي على مجموعة من عناصر تحكم البطاقة التي تعرض حقولاً فردية أو توفر طريقة لتحديث هذه الحقول. تحتوي كل بطاقة على خاصية DataField التي تحدد حقل السجل الذي تعمل عليه.
يتم تعريف البطاقات المعرّفة مسبقًا لأنواع البيانات المختلفة وتجارب المستخدم. على سبيل المثال، قد تكون هناك بطاقة لتحرير حقل رقمي باستخدام عنصر تحكم إدخال النص، وهو جيد لاستخدامه مع لوحة المفاتيح. قد تدعم بطاقة أخرى تحرير رقم باستخدام عنصر تحكم شريط التمرير بدلاً من ذلك. مع تحديد عنصر تحكم النموذج، يمكنك القيام بذلك في الجزء الأيسر، وتحديد بطاقة بسهولة استنادًا إلى حقل.
تحتوي البطاقات بحد ذاتها على عناصر تحكم. تشكل عناصر تحكم البطاقة التجربة الخاصة بعرض حقل واحد وتحريره. على سبيل المثال، قد تحتوي بطاقة رقمية على عنصر تحكم التسمية لتوفير الاسم المعروض للحقل وعنصر تحكم إدخال النص لتوفير محرر لقيمة الحقل. قد تتضمن البطاقة أيضًا عنصر تحكم التسمية يعرض أخطاء التحقق من الصحة التي تحدث وعنصر تحكم التسمية للعلامة النجمية الشائعة للإشارة إلى أن الحقل مطلوب.
يمكنك تخصيص عناصر تحكم بطاقة معرفة مسبقًا عن طريق تغيير حجمها ونقلها وإخفائها وإضافة عناصر تحكم اليها وإجراء أي تغييرات أخرى. يمكنك أيضًا البدء ببطاقة فارغة بالكامل، "بطاقة مخصصة"، يمكنك أن تضيف عليها عناصر تحكم من البداية.
تكون البطاقات المعرفة مسبقًا مؤمنة بشكل افتراضي. في بطاقة مؤمنة، يمكنك تعديل خصائص معينة للبطاقة أو عناصر التحكم الموجودة داخل البطاقة فقط، ولا يمكنك حذف بطاقة مؤمنة. يمكنك عرض قفل البطاقة وإلغاء تأمينها في علامة التبويب عرض من طريقة عرض الخيارات المتقدمة. إذا كانت الخاصية مؤمنة ولا يمكن تعديلها، فستظهر مع أيقونة قفل إلى جانب اسمها. إلغاء تأمين البطاقة هو نشاط متقدم ويجب القيام به بتأنٍ، لأن إنشاء الصيغ تلقائيًا سيتوقف للبطاقة، ولا يمكنك إعادة تأمين البطاقة.
في حاوية النموذج، يتوفر السجل ThisItem ويحتوي على جميع حقول السجل. على سبيل المثال، يتم في أغلب الأحيان تعيين الخاصية Default إلى ThisItem.FieldName.
يمكنك استخدام مرجع Parent لتكوين عنصر تحكم للإشارة إلى خصائص البطاقة. على سبيل المثال، يجب أن يستخدم عنصر تحكم Parent.Default لقراءة الحالة الأولية للحقل من مصدر البيانات. باستخدام Parent بدلاً من الوصول مباشرة إلى المعلومات التي تريدها، يتم تغليف البطاقة بشكل أفضل، ويمكنك تغييرها إلى حقل مختلف من دون فصل الصيغ الداخلية.
راجع التعرف على بطاقات البيانات للحصول على أمثلة حل كيفية تخصيص البطاقات وإلغاء تأمينها وإنشائها.
الخصائص الرئيسية
DataField – اسم الحقل داخل سجل تعرضه هذه البطاقة وتحرره.
- حدد الاسم كسلسلة ثابتة واحدة محاطة بعلامات اقتباس مزدوجة (على سبيل المثال، الاسم)، وليس صيغة.
- قم بإلغاء ربط بطاقة عن طريق تعيين خاصية DataField إلى فارغ. يتم تجاهل خصائص Valid وUpdate للبطاقات غير المرتبطة.
Default - القيمة الأولية لعنصر تحكم قبل تغييرها بواسطة المستخدم.
- بالنسبة إلى كل عنصر تحكم في بطاقة، قم بتعيين هذه الخاصية إلى Parent.Default للإشارة إلى القيمة الافتراضية للحقل وفقًا لمصدر البيانات. على سبيل المثال، قم بتعيين الخاصية Default لشريط التمرير إلى Parent.Default للتأكد من أن المستخدم يبدأ بقيمة عامة لشريط التمرير هذا.
DisplayMode – بإمكان القيم أن تكون تحرير، أو عرض أو معطّل. تكوين ما إذا كان عنصر التحكم داخل البطاقة سيسمح بإدخال المستخدم (تحرير) أو يعرض البيانات فقط (عرض)، أو مُعطل (مُعطل).
- يسمح باستخدام بطاقة واحدة في نموذجي التحرير والعرض، وذلك بتكوين هذه الخاصية، المرتبطة بسلوك النموذج بشكل افتراضي.
- في وضع العرض ستقوم عناصر تحكم مثل إدخال النص، و**القائمة المنسدلة** و**منتقي التاريخ** بعرض فقط قيمة النص ولن تعرض أي عناصر تفاعليه أو زخرفات.
DisplayName – الاسم المألوف للمستخدم لحقل في مصدر بيانات.
- توفر الدالة DataSourceInfo بيانات التعريف هذه من مصدر البيانات.
- يجب أن تستخدم عناصر التحكم الموجودة داخل البطاقة Parent.DisplayName للإشارة إلى اسم الحقل.
Error – رسالة خطأ مألوفة للمستخدم لعرض هذا الحقل عند فشل التحقق من الصحة.
- يتم تعيين هذه الخاصية عند استدعاء SubmitForm.
- تصف الرسالة مشكلات التحقق من الصحة استنادًا إلى بيانات تعريف مصدر البيانات والتحقق من الخاصية Required للبطاقة.
Required – ما إذا كان يجب أن تحتوي بطاقة، تحرر حقل مصدر بيانات، على قيم.
- توفر الدالة DataSourceInfo بيانات التعريف المطلوبة من مصدر البيانات.
- يجب أن تستخدم عناصر التحكم في البطاقة Parent.Required لتحديد ما إذا كان حقل البطاقة مطلوبًا.
Update – القيمة التي يجب كتابتها في مصدر البيانات لحقل.
- استخدم صيغة هذه الخاصية لسحب القيم من عناصر تحكم التحرير الخاصة بالبطاقة من أجل الكتابة مرة أخرى إلى مصدر البيانات. على سبيل المثال، قم بتعيين خاصية Update إلى شريط التمرير.Value لتحديث مصدر البيانات بقيمة من شريط التمرير في هذه البطاقة.
Width – المسافة بين الحواف اليمنى واليسرى لعنصر التحكم.
WidthFit – ما إذا كان عنصر التحكم ينمو تلقائيًا بشكل أفقي لتعبئة المساحة الفارغة لعنصر تحكم حاوية مثل عنصر تحكم نموذج التحرير. إذا تم تعيين هذه الخاصية لبطاقات متعددة إلى صواب، فسيتم تقسيم المساحة بينها. للحصول على مزيد من المعلومات، راجع التعرف على تخطيط نموذج البيانات.
خصائص إضافية
BorderColor – لون حد عنصر التحكم.
BorderStyle – ما إذا كان حد عنصر التحكم بتنسيق ثابت أو متقطع أو منقط أو بلا.
BorderThickness – سُمك حد عنصر التحكم.
Fill – لون خلفية عنصر التحكم.
Height – المسافة بين الحواف العليا والسفلى لعنصر التحكم.
Valid – ما إذا كان عنصر تحكم البطاقة أو نموذج التحرير يحتوي على إدخالات صالحة، جاهزة لإرسالها إلى مصدر البيانات.
Visible – ما إذا كان عنصر التحكم ظاهرًا أم مخفيًا.
X – المسافة بين الحافة اليسرى لعنصر التحكم والحافة اليسرى لحاويته الأصلية (الشاشة في حالة عدم وجود حاوية أصلية). بالنسبة إلى عنصر تحكم البطاقة في حاوية تحتوي على عدة أعمدة، تحدد هذه الخاصية العمود الذي تظهر به البطاقة.
Y – المسافة بين الحافة العلوية لعنصر التحكم والحافة العلوية لحاويته الأصلية (الشاشة في حالة عدم وجود حاوية أصلية). بالنسبة إلى عنصر تحكم البطاقة في حاوية تحتوي على عدة صفوف، تحدد هذه الخاصية الصف الذي تظهر به البطاقة.
الأمثلة
راجع التعرف على بطاقات البيانات and التعرف على تخطيط نموذج البيانات للحصول على امثلة.
إرشادات إمكانية الوصول
تباين الألوان
يجب أن يكون تباين الألوان ملائمًا بين:
- Fill وأي عناصر تحكم فرعية. على سبيل المثال، إذا احتوت بطاقة على عنصر تحكم التسمية وتضمنت التسمية تعبئة شفافة، ستصبح عندئذٍ Fill البطاقة لون خلفية التسمية بشكل فعلي. وبالتالي، يجب أن يكون هناك تباين كافٍ بين Fill البطاقة و**Color** التسمية.
دعم قارئ الشاشة
- يجب أن يكون DisplayName موجودًا.