Confirm دالة

ينطبق على: تطبيقات اللوحة التي تستند إلى نموذج التطبيقات

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

الوصف

Confirm تعرض الدالة مربع حوار أعلى الشاشة الحالية مع زرين: زر تأكيد وزر إلغاء. في التطبيقات المستندة إلى النموذج، يتم تعيين هذه الأزرار افتراضيا على الإصدارات المترجمة من "موافق" و"إلغاء الأمر" على التوالي. Confirm يتوفر أيضا في تطبيقات اللوحة لعرض مربع حوار تأكيد بسيط وإرجاع نتيجة منطقية.

يجب على المستخدم اختيار أحد الأزرار قبل تجاهل مربع الحوار. بالإضافة إلى تحديد الزر إلغاء الأمر، يمكن تجاهل مربع الحوار من خلال الإيماءات الخاصة بالنظام الأساسي (مثل مفتاح Esc أو النقر خارج مربع الحوار). في تطبيقات اللوحة، يتم التعامل مع مسار الفصل هذا على أنه لا يوجد إجراء (أي أنه يرجع blank).

ملحوظة

في تطبيقات اللوحة، تستخدم الدالة Confirm مربع الحوار Fluent. تأكد من تمكين عناصر التحكم الحديثة؛ وإلا، يظهر مربع حوار المستعرض الأصلي.

إعراب

Confirm( Message [, OptionsRecord ] )

• رسالة - مطلوب. الرسالة المُراد عرضها للمستخدم.
• OptionsRecord - اختياري. توفير إعدادات الخيارات لمربع الحوار. انظر أدناه للاطلاع على الخيارات المتوفرة.

الخيارات

استخدم المعلمة OptionsRecord لتخصيص مربع حوار التأكيد:

Option	الوصف
التأكيد	النص الذي يجب عرضه على زر التأكيد، مع استبدال النص المترجم الافتراضي "موافق" أو "Confirm".
زر الإلغاء	النص الذي يجب عرضه على زر إلغاء الأمر، مع استبدال نص "إلغاء" المترجم الافتراضي.
‏‫العنوَان	النص المراد عرضه كعنوان مربع الحوار. يتم عرضه بخط أكبر وأكثر جرأة من الرسالة. قد يتم اقتطاعه إذا كان طويلا جدا.
عنوان فرعي	النص المراد عرضه كعنبر فرعي لمربع الحوار. يتم عرضه بين العنوان والرسالة. قد يتم اقتطاعه إذا كان طويلا جدا.

السلوك الافتراضي

تسميات الأزرار: إذا لم توفر تسميات أزرار مخصصة، Confirm يستخدم نص الزر الافتراضي المترجم:

• في تطبيقات اللوحة (معاينة)، تكون الإعدادات الافتراضية "Confirm" و "إلغاء الأمر" (مترجمة).
• في التطبيقات المستندة إلى النموذج، تكون الإعدادات الافتراضية "OK" و "Cancel" (المترجمة).

القيمة المرجعة:Confirm إرجاع true إذا حدد المستخدم زر التأكيد، وبخلاف false ذلك.

الأمثلة

التطبيقات التي تستند إلى النموذج

تأكيد بسيط قبل إزالة سجل

If( Confirm( "Are you sure?" ), Remove( ThisItem ) )

يعرض مربع حوار تأكيد مع أزرار افتراضية. إذا حدد المستخدم زر التأكيد، تتم إزالة السجل.

تأكيد بعنوان مخصص

If( Confirm( "Are you sure?", { Title: "Delete Confirmation" } ), Remove( ThisItem ) )

إضافة عنوان إلى مربع حوار التأكيد قبل إزالة سجل.

تسميات الأزرار المخصصة لتفضيل المستخدم

Set( FavColor,
     If( Confirm( "What is your favorite color?",
                  { ConfirmButton: "Red", CancelButton: "Green" }
         ),
         "Red",
         "Green"
     )
)

يستخدم تسميات الأزرار المخصصة لالتقاط تفضيل بسيط. يتم تخزين النتيجة في المتغير FavColorالعمومي .

رسالة مشروطة دون التحقق من القيمة المرجعة

Confirm( "There was a problem, please review your order." )

يعرض رسالة مشروطة يجب أن يقر بها المستخدم قبل المتابعة. لم يتم تحديد القيمة المرجعة.

---

تَطبِيقَات اللوحة

Confirm قبل الحذف

استخدم Confirm لمنع الحذف العرضي للسجلات:

// Button.OnSelect
If(
    Confirm(
        "Are you sure you want to delete this record?",
        {
            Title: "Delete confirmation",
            Subtitle: "This action can't be undone.",
            ConfirmButton: "Delete",
            CancelButton: "Cancel"
        }
    ),
    Remove(YourDataSource, Gallery1.Selected);
    Notify("Record deleted.", NotificationType.Success)
)

يعرض مربع حوار تأكيد مع العنوان والعنوان الفرعي وتسميات الأزرار المخصصة. يتم حذف السجل فقط إذا حدد المستخدم Delete.

Confirm قبل حفظ نموذج

استخدم Confirm للتحقق من صحة هدف المستخدم قبل إرسال البيانات:

// Save button.OnSelect
If(
    Confirm(
        "Do you want to save these changes?",
        { Title: "Save changes" }
    ),
    SubmitForm(EditForm1);
    ResetForm(EditForm1);
    Notify("Changes saved successfully.", NotificationType.Success)
)

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

تخزين النتيجة في متغير لإجراءات متعددة

تخزين نتيجة التأكيد لاستخدامها في عمليات انتقال البيانات من الخادم المتعددة:

// Button.OnSelect
Set(
    varConfirmed,
    Confirm("Do you want to proceed with this operation?")
);

If(
    varConfirmed,
    Notify("Processing your request...", NotificationType.Information);
    /* Additional operations */,
    Notify("Operation canceled.", NotificationType.Warning)
)

يتم تخزين النتيجة المنطقية في varConfirmed ويمكن الرجوع إليها عدة مرات للمنطق الشرطي.

التخصيص الكامل مع جميع الخيارات

عرض جميع خيارات التخصيص المتوفرة:

// Button.OnSelect
If(
    Confirm(
        "This is the main message that describes what the user needs to confirm.",
        {
            Title: "Action Required 🔔",
            Subtitle: "Please choose one of the options below.",
            ConfirmButton: "Yes, proceed",
            CancelButton: "No, cancel"
        }
    ),
    Notify("User confirmed!", NotificationType.Success),
    Notify("User canceled.", NotificationType.Warning)
)

يعرض مربع حوار مخصص بالكامل مع العنوان والعنوان الفرعي والرسالة وتسميات الأزرار المخصصة.

الأسئلة الشائعة

هل يمكنني إخفاء الزر "إلغاء الأمر"؟

‏‏لا. يعرض التصميم الحالي دائما كلا من Confirm الزرين وإلغاء الأمر. يجب أن يكون لدى المستخدمين القدرة على تجاهل مربع الحوار أو إلغائه.

هل يمكنني إضافة زر ثالث أو أكثر من خيارين؟

‏‏لا. Confirm يدعم خيارين بالضبط: إجراء تأكيد وإجراء إلغاء. بالنسبة للسيناريوهات التي تتطلب خيارات متعددة، ضع في اعتبارك استخدام نمط واجهة مستخدم مختلف مثل شاشة مخصصة أو عنصر تحكم منسدلة.

هل Confirm تحظر العمليات الأخرى؟

نعم. Confirm يعرض كمربع حوار مشروط يجب على المستخدم تجاهله قبل أن يتمكن من التفاعل مع أجزاء أخرى من التطبيق.

راجع أيضًا

إعلام - يعرض رسالة شعار غير مشروط في أعلى الشاشة لا تتطلب فصل المستخدم.