إنتقل إلى المحتوى الرئيسي

Dialog:show()

إذا استدعيت هذه الدالة، سيظهر مربع الحوار منبثقًا على الشاشة

المعاملات​

المعاملاتالنوعالوصف
timeoutMsnumberمهلة اختيارية بالمللي ثانية قبل التأكيد التلقائي لمربع الحوار

التوقيع​

Dialog:show(): void
Dialog:show(timeoutMs: number): void

القيمة المعادة

void

الوصف​

تعرض Dialog:show() مربع الحوار وتنتظر من المستخدم الضغط على OK أو Cancel.

إذا مررت timeoutMs، سيقوم مربع الحوار بتشغيل الزر الإيجابي تلقائيًا بعد التأخير المحدد. يكون هذا مفيدًا عندما ترغب في عرض المعاملات لفترة وجيزة لكن متابعة التنفيذ تلقائيًا.

أمثلة​

Dialog:init()
Dialog:setTitle("Confirm action")
Dialog:setMessage("Press OK to continue")
Dialog:show()
Dialog:init()
Dialog:setTitle("Quick notice")
Dialog:setMessage("This dialog will continue automatically")
Dialog:show(3000)

ملاحظات​

  • Dialog:show() تكافئ Dialog:show(0)
  • قيمة المهلة الأكبر من 0 تُفعّل سلوك التأكيد التلقائي
  • إذا ألغى المستخدم مربع الحوار أو رفضه، يُلقي تنفيذ الماكرو استثناءً