إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
ينطبق على:
تطبيقات اللوحة التي تستند إلى نموذج التطبيقات Power Platform CLI
عرض رسالة شعار للمستخدم.
الوصف
Notify تعرض الدالة رسالة شعار للمستخدم في أعلى الشاشة. ويظل الإشعار قائمًا حتى يرفضه المستخدم أو تنتهي المهلة الافتراضية وهي 10 ثوانٍ.
يتم استخدام اللون والرمز المناسبين اعتمادًا على نوع الرسالة. يتم تحديد النوع بواسطة الوسيطة الثانية للوظيفة:
ملاحظة
حد الأحرف للدالة Notify هو 500 حرف.
| وسيطة NotificationType | الوصف |
|---|---|
| نوع الإخطار.خطأ | عرض الرسالة كخطأ. |
| نوع الإخطار.المعلومات (افتراضي) | عرض الرسالة كمعلومات. |
| نوع الإخطار.النجاح | عرض الرسالة كنجاح. |
| نوع الإشعار.تحذير | عرض الرسالة كتحذير. |
يتم عرض الرسائل عند تأليف تطبيقك وعندما يستخدم المستخدمون تطبيقك.
Notify يمكن استخدام فقط في صيغ السلوك.
Notify يمكن إقرانها بدالة IfError للكشف عن الأخطاء والإبلاغ عنها برسالة خطأ مخصصة.
يمكن ل Power Apps أيضا إرسال إشعارات الدفع باستخدام آلية مختلفة تماما عن Notify. لمزيد من المعلومات، راجع إرسال إخطار في Power Apps.
Notify دائما ما ترجع true.
ملاحظة: تم تسمية هذه الوظيفة سابقًا باسم ShowError عندما يمكن عرض رسائل الخطأ فقط.
ملاحظة
Notify يمكن استخدامها في تطبيق اللوحة المستقلوالصفحة المخصصة وتجارب أوامر Power Fx . تختلف القيم الافتراضية ل NotificationType وOutout حسب التجربة المستخدمة فيه. يمكنك تحديد القيم التي تريد تعيينها ل NotificationType وOutoutout Power Fx عن طريق تعيينها بوضوح في تعبيرك ويتم اعتبار هذه القيم بغض النظر عن الخبرة.
بناء الجملة
Notify( Message [, NotificationType [ , Timeout ] ] )
- رسالة - مطلوب. الرسالة المُراد عرضها للمستخدم.
- نوع الإخطار- اختياري. نوع الرسالة التي سيتم عرضها من الجدول السابق. الإعداد الافتراضي هو NotificationType.Information.
- مهلة - اختياري. عدد المللي ثانية التي يجب انتظارها قبل رفض الإشعار تلقائيًا. القيمة الافتراضية هي 10 ثوانٍ (أو 10000 مللي ثانية). يتم عرض الإخطار إلى أجل غير مسمى مع مهلة بالغة 0.
الأمثلة
خطوة بخطوة
أضف عنصر تحكم Button إلى شاشتك.
قم بتعيين خاصية OnSelect الخاصة بـ Button إلى الصيغة:
Notify( "Hello, World" )انقر فوق الزر أو اضغط عليه.
في كل مرة يتم فيها النقر فوق الزر، يتم عرض الرسالة Hello, World للمستخدم كمعلومات. يتم رفضه تلقائيًا خلال 10 ثوانٍ (المهلة الافتراضية) إذا لم يقم المستخدم بإغلاقه أو الضغط على الزر مرة أخرى.
قم بتغيير نوع الرسالة للإشارة إلى خطأ. أضف وسيطة ثانية إلى صيغتنا:
Notify( "Hello, World", NotificationType.Error )انقر فوق الزر أو اضغط عليه.
الآن في كل مرة يتم فيها النقر فوق الزر، يتم عرض الرسالة Hello, World للمستخدم كخطأ. يتم رفضه تلقائيًا خلال 10 ثوانٍ (المهلة الافتراضية) إذا لم يقم المستخدم بإغلاقه أو الضغط على الزر مرة أخرى.
قم بتغيير نوع الرسالة للإشارة إلى تحذير. قم بتغيير الوسيطة الثانية في صيغتنا:
Notify( "Hello, World", NotificationType.Warning, 4000 )انقر فوق الزر أو اضغط عليه.
الآن في كل مرة يتم فيها النقر فوق الزر، يتم عرض الرسالة Hello, World للمستخدم كتحذير. يتم رفضه تلقائيًا خلال 4 ثوانٍ (4000 مللي ثانية) إذا لم يقم المستخدم بإغلاقه أو الضغط على الزر مرة أخرى.
قم بتغيير نوع الرسالة للإشارة إلى نجاح. قم بتغيير الوسيطة الثانية في صيغتنا:
Notify( "Hello, World", NotificationType.Success, 0 )انقر فوق الزر أو اضغط عليه.
والآن في كل مرة يتم فيها النقر فوق الزر، يتم عرض الرسالة Hello, World للمستخدم كنجاح. مع مهلة 0، سيتم رفض الإشعار فقط من قِبل المستخدم أو عن طريق الضغط على الزر مرة أخرى.
