Share via

عنصر تحكم عارض PDF (تجريبي) في Power Apps

  • مقالة

عنصر تحكم تجريبي يعرض محتويات ملف PDF.

‏‏الوصف

يمكنك إظهار النص والرسومات والمحتويات الأخرى في ملف PDF عن طريق إضافة هذا النوع من عناصر التحكم وتعيين خاصية Document الخاصة به إلى عنوان URL، ضمن علامات اقتباس مزدوجة، للملف الذي تريد عرضه.

القيود

  1. يدعم عنصر تحكم عارض PDF فقط ملفات PDF التي تتوافق مع مواصفات PDF32000.

  2. تتطلب هندسة الأمان لـ Power Apps أن يدعم عارض PDF ارتباطات HTTPS فقط، وليس HTTP.

  3. يجب أن ترتبط خاصية Document مباشرة بملف PDF. إعادة توجيه الخادم أو طرق عرض HTML الخاصة بالمستند غير مدعومة.

  4. يجب ألا يطلب الخادم الذي يستضيف المستند المصادقة.

  5. قد لا تتمكن من عرض مستند PDF في تطبيقك عند وجود المستند موجود على خادم لديه إعدادات مقيدة لمشاركة الموارد عبر الأصل (CORS). لحل هذه المشكلة، يجب أن يسمح الخادم الذي يستضيف مستندات PDF بالطلبات عبر الأصل من powerapps.com.

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

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

Document – عنوان URL الموضوع في علامات اقتباس مزدوجة لملف PDF.

خصائص إضافية

ActualZoom – التكبير/التصغير الفعلي لعنصر التحكم، والذي قد يختلف عن التكبير/التصغير المطلوب بواسطة الخاصية Zoom.

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

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

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

CurrentFindText – مصطلح البحث الحالي قيد الاستخدام.

CurrentPage – رقم الصفحة في ملف PDF الجاري عرضه حاليًا.

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

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

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

FindNext – العثور على مثيل FindText التالي في المستند.

FindPrevious – العثور على مثيل FindText السابق في المستند.

FindText – مصطلح البحث المطلوب البحث عنه في المستند.

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

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

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

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

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

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

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

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

Page – رقم الصفحة التي تريد عرضها.

PageCount – عدد الصفحات في مستند.

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

ShowControls – ما إذا كان مشغل الصوت أو الفيديو يعرض، على سبيل المثال، زر تشغيل وشريط تمرير مستوى الصوت، وما إذا كان عنصر تحكم القلم يعرض، على سبيل المثال، أيقونات للرسم والمحو والمسح.

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

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

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

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

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

Zoom – النسبة المئوية التي يتم بها تكبير الصورة من الكاميرا أو عرض ملف في عارض PDF.

‎اختصارات لوحة المفاتيح

  • J - صفحة لأسفل
  • K - صفحة لأعلى
  • N - صفحة لأسفل
  • R - تدوير جميع الصفحات بمقدار 90 درجة عكس عقارب الساعة

مثال

أضف عنصر تحكم عارض PDF وعيّن خاصية Document فيه إلى عنوان URL، مضمن بين علامات اقتباس مزدوجة، لملف PDF في هذا المثال:

"https://blog.mozilla.org/security/files/2015/05/HTTPS-FAQ.pdf"

يعرض عنصر التحكم ملف PDF.

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

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

ميزات إمكانية الوصول لمستندات PDF ليست كلها مدعومة لأن عارض PDF ما زال في المرحلة التجريبية. وبالتالي، يجب تعيين ShowControls إلى صواب للسماح للمستخدمين بفتح المستند في تطبيق خارجي.

تعرف على كيفية إنشاء مستندات PDF يمكن الوصول إليها بسهولة باستخدام مقاييس WCAG 2.0 وPDF/UA.

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

  • يمكنك إضافة عنوان باستخدام التسمية، في حال عدم وجود عنوان لمستند PDF. يمكن وضع العنوان مباشرةً قبل عارض PDF.