تبديل التحكم في Power Apps

عنصر تحكم يمكن للمستخدم تشغيله أو إيقاف تشغيله عن طريق نقل مقبضه.

‏‏الوصف

تم تصميم مفتاح التبديل لواجهات برمجة التطبيقات (GUIs) الأخيرة ولكنه يتصرف بنفس الطريقة التي تتصرف بها خانة الاختيار.

الخصائص الرئيسية

الافتراضي - القيمة الأولية لعنصر تحكم قبل تغييره من قبل المستخدم.

Value – قيمة عنصر تحكم الإدخال.

خصائص إضافية

AccessibleLabel – تسمية لقارئات الشاشة.

BorderColor – لون حد عنصر التحكم.

BorderStyle – سواء كان حد عنصر التحكم متصلا أو متقطعا أو منقطا أو بلا.

BorderThickness – سمك حد عنصر التحكم.

DisplayMode – سواء كان عنصر التحكم يسمح بإدخال المستخدم (تحرير)، أو يعرض البيانات فقط (عرض)، أو معطل (معطل).

DisabledBorderColor – لون حد عنصر التحكم إذا تم تعيين الخاصية DisplayMode لعنصر التحكم إلى معطل.

FalseFill – لون تعبئة التبديل عند إيقاف تشغيل التبديل.

FalseHoverFill – لون تعبئة تمرير التبديل عند إيقاف تشغيل التبديل.

FalseText – النص الذي يظهر عند إيقاف تشغيل التبديل.

تعبئة – لون خلفية عنصر تحكم.

FocusedBorderColor – لون حد عنصر التحكم عند تركيز عنصر التحكم.

FocusedBorderThickness – سمك حد عنصر التحكم عند تركيز عنصر التحكم.

HandleFill – لون تعبئة مقبض التبديل.

الارتفاع – المسافة بين الحافتين العلوية والسفلية لعنصر التحكم.

HoverBorderColor – لون حد عنصر التحكم عندما يحافظ المستخدم على مؤشر الماوس على عنصر التحكم هذا.

OnChange – الإجراءات التي يجب تنفيذها عندما يغير المستخدم قيمة عنصر تحكم (على سبيل المثال، عن طريق ضبط شريط تمرير).

OnCheck – الإجراءات التي يجب تنفيذها عند تغيير قيمة خانة اختيار أو تبديل إلى true.

OnSelect – الإجراءات التي يجب تنفيذها عند لمس المستخدم لعنصر تحكم أو النقر فوقه.

OnUncheck – الإجراءات التي يجب تنفيذها عند تغيير قيمة خانة اختيار أو تبديل إلى خطأ.

PressedBorderColor – لون حد عنصر التحكم عندما يضغط المستخدم على عنصر التحكم هذا أو ينقر فوقه.

RailFill – لون خلفية المستطيل في عنصر تحكم التبديل عندما تكون قيمته خاطئة أو لون الخط الموجود على يمين المقبض في عنصر تحكم شريط التمرير.

RailHoverFill – عند المرور فوق عنصر تحكم تبديل أو شريط تمرير، يكون لون خلفية المستطيل في عنصر تحكم تبديل عندما تكون قيمته خاطئة أو لون الخط الموجود على يمين المقبض في عنصر تحكم شريط التمرير.

إعادة تعيين - ما إذا كان عنصر التحكم يعود إلى قيمته الافتراضية.

ShowLabel – ما إذا كان يتم عرض تسمية نصية بجانب عنصر تحكم التبديل.

TabIndex – ترتيب التنقل في لوحة المفاتيح فيما يتعلق بعناصر التحكم الأخرى.

TextPosition – سواء كانت التسمية إلى يسار عنصر تحكم التبديل أو يمينه.

تلميح الأدوات – نص توضيحي يظهر عندما يقوم المستخدم بالمرور فوق عنصر تحكم.

TrueFill – تبديل لون التعبئة عند تشغيل التبديل.

TrueHoverFill – تبديل لون تعبئة المرور عند تشغيل التبديل.

TrueText – النص الذي يظهر عند تشغيل التبديل.

ValueFill – لون خلفية المستطيل في عنصر تحكم تبديل عندما تكون قيمته صحيحة أو لون الخط إلى يسار المقبض في عنصر تحكم شريط التمرير.

ValueHoverFill – عند إبقاء مؤشر الماوس على عنصر تحكم تبديل أو شريط تمرير، يكون لون خلفية المستطيل في عنصر تحكم تبديل عندما تكون قيمته صحيحة أو لون الخط إلى يسار المقبض في عنصر تحكم شريط التمرير.

مرئي – سواء ظهر عنصر تحكم أو تم إخفاؤه.

العرض - المسافة بين الحافتين اليسرى واليمين لعنصر التحكم.

X – المسافة بين الحافة اليسرى لعنصر التحكم والحافة اليسرى للحاوية الأصل الخاصة به (شاشة إذا لم تكن هناك حاوية أصل).

Y – المسافة بين الحافة العليا لعنصر التحكم والحافة العليا للحاوية الأصل (شاشة إذا لم تكن هناك حاوية أصل).

الدالات ذات الصلة

If( Condition, Result )

مثال

1. أضف مفتاح تبديل، وقم بتسمائه MemberDiscount.

   ألا تعرف كيفية إضافة عنصر تحكم وتسميه وتكوينه؟

2. أضف تسمية، ثم قم بتعيين الخاصية Text الخاصة بها إلى هذه الصيغة:
   If(MemberDiscount.Value = true, "Price: $75", "Price: $100")

   هل تريد المزيد من المعلومات حول الدالة If أو دالات أخرى؟

3. اضغط على F5، وقم بتغيير قيمة MemberDiscount.

   تعرض التسمية سعرا مختلفا، اعتمادا على ما إذا كان MemberDiscount قيد التشغيل أو متوقفا عن التشغيل.

4. للعودة إلى مساحة العمل الافتراضية، اضغط على مفتاح الخروج Esc.

إرشادات إمكانية الوصول

تباين الألوان

يجب أن يكون هناك تباين ألوان كاف بين:

• HandleFill و FalseFill
• HandleFill و FalseHoverFill
• HandleFill و TrueFill
• HandleFill و TrueHoverFill
• FalseFill واللون خارج عنصر التحكم
• FalseHoverFill واللون خارج عنصر التحكم
• ملء صحيح ولون خارج عنصر التحكم
• TrueHoverFill واللون خارج عنصر التحكم

هذا بالإضافة إلى متطلبات تباين الألوان القياسية.

دعم قارئ الشاشة

• يجب أن يكون AccessibleLabel موجودا.
• يجب أن يكون FalseText موجودا.
• يجب أن يكون TrueText موجودا.

دعم ضعف البصر

• ضع في اعتبارك تعيين ShowLabel إلى true بحيث يمكن للمستخدمين تحديد قيمة التبديل بسرعة.

دعم لوحة المفاتيح

• يجب أن يكون TabIndex صفرا أو أكبر حتى يتمكن مستخدمو لوحة المفاتيح من الانتقال إليه.
• يجب أن تكون مؤشرات التركيز مرئية بوضوح. استخدم FocusedBorderColorوFofoedBorderThickness لتحقيق ذلك.