مشاركة عبر

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

  • مقالة

عنصر تحكم يسمح للمستخدمين بتنزيل الملفات إلى أجهزتهم، بالإضافة إلى تحميل وحذف ملفات من قائمة تم إنشاؤها باستخدام قوائم Microsoft أو جدول Microsoft Dataverse.

الوصف

يتيح لك عنصر تحكم المرفقات فتح الملفات وإضافتها وحذفها من قائمة أو جدول Dataverse.

القيود

يتضمن attachment control هذه القيود:

  1. يدعم attachment control القوائم Dataverse والجداول فقط كمصدري البيانات.

  2. تعمل دالات التحميل والحذف فقط داخل النموذج. يظهر Attachment control معطلاً عندما يكون في وضع التحرير وليس داخل النموذج. ولحفظ إضافات وحذف الملفات، يجب على مستخدم التطبيق حفظ النموذج. بسبب هذه القيود، لا يتوفر Attachment control من علامة التبويب Insert ولكنه يظهر في النموذج عند تمكين نموذج المرفقات في نموذج SharePoint أو Dataverse.

  3. يتيح لك عنصر تحكم المرفقات في مستعرض الويب تحديد ملفات متعددة، كما يسمح باستخدام دالة السحب والإفلات. ومع ذلك، عند استخدام عنصر تحكم المرفقات على Power Apps Mobile, يمكنك إضافة ملفات مرة واحدة فقط في كل مرة.

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

العناصر - عمود المرفق في القائمة أو الجدول Dataverse. مجموعات و جدول غير مدعومة.

MaxAttachments – الحد الأقصى لعدد الملفات التي سيقبلها عنصر التحكم.

MaxAttachmentSize – الحد الأقصى لحجم الملف المسموح به بالميغابايت في كل مرفق جديد. 1 ميجا بايت هنا تعني 1.000.000 بايت (106 B) أو 1.000 كيلو بايت.

OnAddFile – إجراءات يتم تنفيذها عند إضافة المستخدم لمرفق ملف جديد.

OnRemoveFile - إجراءات يتم تنفيذها عندما يقوم المستخدم بحذف مرفق موجود.

OnUndoRemoveFile - إجراءات يتم تنفيذها عندما يقوم المستخدم باستعادة مرفق محذوف.

خصائص إضافية

AccessibleLabel – تسمية لقارئات الشاشة. يجب أن تصف الغرض من المرفقات.

AddAttachmentText – نص التسمية للارتباط الذي تم استخدامه لإضافة مرفق جديد.

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

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

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

Color – لون نص عنصر تحكم.

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

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

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

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

[DropTargetBackgroundColor]– لون الخلفية الهدف المنسدل لعنصر التحكم.

[DropTargetBorderColor]– لون الحد الهدف المنسدل لعنصر التحكم.

[DropTargetBorderStyle] – ما إذا الحد الهدف لإسقاط عنصر التحكم هو متصل، أو متقطع، أو منقط، أو بلا.

[DropTargetBorderThickness]– سماكة الحد الهدف لإسقاط عنصر التحكم.

[DropTargetTextColor]– لون الحد الهدف لإسقاط عنصر التحكم.

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

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

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

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

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

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

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

HoverColor – لون النص في عنصر التحكم عندما يُبقي المستخدم مؤشر الماوس عليه.

HoverFill – خلفية نص عنصر التحكم عندما يُبقي المستخدم مؤشر الماوس عليه.

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

MaxAttachmentsText – النص الذي يحل محل الارتباط "إرفاق ملف" عندما يحتوي عنصر التحكم على الحد الأقصى لعدد الملفات المسموح به.

NoAttachmentsText – النص الإعلامي الذي يظهر للمستخدم عند عدم وجود ملفات مرفقة.

Padding – المسافة بين النص في زر استيراد أو تصدير وحواف هذا الزر.

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

PressedColor – لون النص في عنصر تحكم عندما يحدد المستخدم عنصر التحكم هذا.

PressedFill – لون خلفية عنصر التحكم عندما يحدد المستخدم عنصر التحكم هذا.

Reset – إعادة جميع التغييرات إلى عنصر تحكم المرفقات التي تعود إلى الحالة المحفوظة السابقة.

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

Strikethrough - ما إذا كان أي خط يظهر عبر النص الذي يظهر على عنصر تحكم.

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

Tooltip - نص تفسيري يظهر عند تمرير المستخدم للماوس فوق عنصر تحكم.

Underline - ما إذا كان أي خط يظهر أسفل النص الذي يظهر على عنصر تحكم.

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

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

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

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

مثال

  1. أضف نموذجًا إلى تطبيقك، وعيّن قائمة كمصدر بيانات له.

  2. حدد عنصر تحكم نموذج العرض في طريقة عرض الشجرة على الجانب الأيمن. يمكنك أيضًا استخدام Edit Form بدلاً من ذلك.

  3. حدد Data Source في علامة التبويب "خصائص" في لوحة الخيارات الموجودة إلى اليسار ثم حدد القائمة التي اتصلت بها.

  4. حدد تحرير الحقول في قسم الحقول‏‎ وحدد إضافة حقل.

  5. حدد حقل المرفقات ثم حدد إضافة.

    سيظهر حقل المرفقات المقترن بالقائمة في النموذج.

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

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

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

يجب أن يكون تباين الألوان ملائمًا بين:

  • ItemColor و ItemFill
  • ItemHoverColor و ItemHoverFill
  • ItemPressedColor و ItemPressedFill
  • AddedItemColor و AddedItemFill
  • RemovedItemColor و RemovedItemFill
  • ItemErrorColor و ItemErrorFill
  • AddAttachmentColor و Fill
  • MaxAttachmentsColor و Fill
  • NoAttachmentsColor و Fill

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

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

يجب أن تكون الخصائص التالية موجودة:

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

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