مشاركة عبر

عنصر تحكم منتقي التاريخ في Power Apps

  • مقالة

عنصر تحكم يمكن للمستخدم تحديده لتحديد تاريخ.

الوصف

إذا قمت بإضافة عنصر تحكم منتقي التاريخ بدلاً من عنصر تحكم إدخال النص، فأنت بذلك تساعد على التأكد من قيام المستخدم بتحديد تاريخ بالتنسيق الصحيح.

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

DefaultDate – القيمة الأولية لعنصر تحكم تاريخ إلا إذا قام المستخدم بتغييرها.

SelectedDate – التاريخ المحدد حاليًا في عنصر تحكم التاريخ. هذا التاريخ ممثل بالتوقيت المحلي.

Format – تنسيق النص الذي يستخدمه عنصر التحكم لإظهار التاريخ ويستخدمه المستخدم لتحديد التاريخ.. يمكنك تعيين هذه الخاصية إلى ShortDate (افتراضي) أو LongDate لتنسيق التواريخ استنادًا إلى خاصية Language لعنصر التحكم هذا. يمكنك أيضًا تعيين هذه الخاصية إلى تعبير، مثل yyyy/mm/dd إذا أردت استخدام التنسيق نفسه بصرف النظر عن اللغة. على سبيل المثال:

  • يعرض عنصر التحكم هذا التاريخ 12/31/2017 إذا قام المستخدم بالنقر أو الضغط على اليوم الأخير من عام 2017، يتم تعيين خاصية Format إلى ShortDate، يتم تعيين خاصية Language إلى en-us.
  • يعرض عنصر التحكم هذا التاريخ dimanche 31 decembre 2017 إذا قام المستخدم بالنقر أو الضغط على اليوم الأخير من عام 2017، يتم تعيين خاصية Format إلى LongDate، يتم تعيين خاصية Language إلى fr-fr.

Language – تحدد اللغة التي يتم استخدامها لتنسيق التواريخ، بما في ذلك أسماء الأشهر. إذا لم يتم تحديد هذه الخاصية، سيحدد إعداد جهاز المستخدم اللغة. القيم المدعومة تتضمن "EN-us" و"FR".

خصائص إضافية

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

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

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

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

Color – لون النص في أحد عناصر التحكم.

DateTimeZone – ما إذا كان يجب عرض التاريخ بتنسيق UTC أو الوقت المحلي للمستخدم.

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

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

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

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

EndYear – آخر سنة يمكن للمستخدم أن يُعيّن لها قيمة عنصر تحكم منتقي التاريخ.

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

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

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

Font – اسم عائلة الخطوط التي يظهر فيها النص.

FontWeight – سماكة النص في عنصر التحكم: غامق أو شبه غامق أو عادي أو فاتح.

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

IconFill – لون مقدمة أيقونة منتقي التاريخ.

IconBackground – لون خلفية أيقونة منتقي التاريخ.

InputTextPlaceholder – النص الإرشادي الذي يظهر إذا لم يتم إدخال أي تواريخ.

IsEditable - ما إذا كان يمكن تحرير نص منتقي التاريخ. إذا كانت القيمة "خطأ"، فيمكن تغيير التاريخ باستخدام التقويم فقط.

Italic - ما إذا كان النص الموجود في عنصر التحكم مائلاً.

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

OnChange – إجراءات يتم تنفيذها عند تغيير المستخدم لقيمة عنصر التحكم.

الفرق بين OnChange وOnSelect: يتم تشغيل OnSelect و OnChange على إجراء المستخدم نفسه إذا تسبب نقر المستخدم بحدوث التغيير. في هذه الحالة، يتم تشغيل OnSelect قبل OnChange.

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

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

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

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

Reset - ما إذا كان عنصر تحكم منتقي التاريخ ينبغي إعادة تعيينه إلى قيمة DefaultDate.

Size – حجم خط النص الذي يظهر في عنصر التحكم.

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

StartYear – السنة الأقرب التي يمكن للمستخدم أن يُعيّن لها قيمة عنصر تحكم منتقي التاريخ.

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

Visible – ما إذا كان عنصر التحكم ظاهرًا أم مخفيًا.‬

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

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

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

Year( DateTimeValue )

الأمثلة

منتقي التاريخ الكلاسيكي

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

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

  2. قم بإضافة عنصر تحكم التسمية، ثم قم بتعيين الخاصية Text الخاصة به إلى الصيغة التالية:

     DateDiff(Today(), Deadline.SelectedDate) & " days to go!"

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

  3. اضغط على F5، اختر تاريخا في الموعد النهائي، ثم حدد موافق.

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

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

إعادة تعيين منتقي التاريخ إلى التاريخ الافتراضي

  1. أضف عنصر تحكم منتقي التاريخ باسم "DateTimeReset".

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

  2. قم بإضافة عنصر تحكم الزر، ثم قم بتعيين الخاصية OnChange الخاصة به إلى الصيغة التالية:

    Reset(DateTimeReset)

  3. اضغط على F5، اختر تاريخا جديدًا في DateTimeReset، ثم حدد موافق.

  4. اضغط على الزر. سيتم إعادة تعيين التاريخ مرة أخرى إلى DefaultDate (اليوم).

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

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

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

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

  • يلزم وجود AccessibleLabel.
  • إذا كان IsEditable صحيحًا وFormat ليس ما يتوقعه المستخدمون، فأضف التسمية لتوضيح تنسيقات القوالب المقبولة.

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

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

تلميح

عندما يكون التقويم مفتوحًا، اضغط على Page up وعلى Page down للتنقل بين الأشهر وعلى Shift+Page up وعلى Shift+Page down للتنقل بين السنوات.