الدالة Notify
ينطبق على:
تطبيقات اللوحة التطبيقات Power Platform المستندة إلى النموذج CLI
عرض رسالة شعار للمستخدم.
الوصف
تعرض دالة Notify رسالة شعار للمستخدم أعلى الشاشة. ويظل الإشعار قائمًا حتى يرفضه المستخدم أو تنتهي المهلة الافتراضية وهي 10 ثوانٍ.
يتم استخدام اللون والرمز المناسبين اعتمادًا على نوع الرسالة. يتم تحديد النوع بواسطة الوسيطة الثانية للوظيفة:
ملاحظة
حد الأحرف لوظيفة Notify هو 500 حرف.
| وسيطة NotificationType | الوصف |
|---|---|
| نوع الإخطار.خطأ | عرض الرسالة كخطأ. |
| نوع الإخطار.المعلومات (افتراضي) | عرض الرسالة كمعلومات. |
| نوع الإخطار.النجاح | عرض الرسالة كنجاح. |
| نوع الإشعار.تحذير | عرض الرسالة كتحذير. |
يتم عرض الرسائل عند تأليف تطبيقك وعندما يستخدم المستخدمون تطبيقك.
لا يمكن استخدام Notify إلا في صيغ السلوك.
يمكن إقران Notify بوظيفة IfError لاكتشاف الأخطاء والإبلاغ عنها برسالة خطأ مخصصة.
كما يمكن لـ Power Apps إرسال إخطارات الدفع باستخدام آلية مختلفة تمامًا عن وظيفة Notify. لمزيد من المعلومات، راجع إرسال إخطار في Power Apps.
إعلام دائما إرجاع صواب.
ملاحظة: تم تسمية هذه الوظيفة سابقًا باسم ShowError عندما يمكن عرض رسائل الخطأ فقط.
ملاحظة
يمكن استخدام الإعلام في تطبيق اللوحة مستقل وصفحة مخصصة Power Fx والخبرات الأمر . تختلف القيم الافتراضية ل NotificationType وOutout حسب التجربة المستخدمة فيه. يمكنك تحديد القيم التي تريد تعيينها ل NotificationType وOutoutout Power Fx عن طريق تعيينها بوضوح في تعبيرك ويتم اعتبار هذه القيم بغض النظر عن الخبرة.
بناء الجملة
إخطار ( رسالة [، نوع الإخطار [ ، مهلة ]] )
- رسالة - مطلوب. الرسالة المُراد عرضها للمستخدم.
- نوع الإخطار- اختياري. نوع الرسالة التي سيتم عرضها من الجدول السابق. الإعداد الافتراضي هو 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، سيتم رفض الإشعار فقط من قِبل المستخدم أو عن طريق الضغط على الزر مرة أخرى.
