أداة إنشاء مربع الحوار (Dialog Builder)

ما هي أداة إنشاء مربع الحوار؟

أداة إنشاء مربع الحوار (Dialog Builder) هي ميزة مفيدة تتيح لك إنشاء مربعات حوار تفاعلية داخل الماكرو الخاص بك. وتُستخدم مربعات الحوار هذه عادةً لجمع المدخلات من المستخدمين قبل أن يبدأ الماكرو تنفيذه الرئيسي. اعتبرها طريقة لتخصيص سلوك الماكرو الخاص بك بناءً على اختيارات المستخدم.

على سبيل المثال، يمكنك إنشاء مربع حوار يسأل "ما الخيار الذي تريد تشغيله؟". وإذا اختار المستخدم الخيار 5، فسينفّذ الماكرو مجموعة محددة من الإجراءات المرتبطة بهذا الاختيار.

مكوّنات مربع الحوار

تُبنى مربعات الحوار باستخدام مكوّنات واجهة مستخدم متنوعة. ويمكن أن يتضمن كل مربع حوار العناصر التالية:

1. CheckBox: للاختيارات بنعم/لا أو صحيح/خطأ
2. EditText: لإدخال نص حر
3. RadioGroup: حاوية لأزرار RadioButton متعددة
4. Column: حاوية تخطيط عمودية
5. Row: حاوية تخطيط أفقية
6. RadioButton: للاختيارات أحادية داخل RadioGroup
7. TextView: لعرض معلومات نصية

القيم الافتراضية

يمكن لمكوّنات إدخال مربع الحوار الآن تعريف قيم ابتدائية قبل عرض مربع الحوار:

• EditText(id, hint, defaultValue) يضبط النص الابتدائي
• CheckBox(id, text, defaultChecked) يضبط حالة التحديد الابتدائية
• RadioGroup(id, defaultButtonId) يحدد زر اختيار بشكل افتراضي

عند تقديم قيمة افتراضية، تُستخدم أولًا عند فتح مربع الحوار.

بناء مربع الحوار الخاص بك

يمكنك دمج هذه المكوّنات لإنشاء مربع حوار مخصص يناسب احتياجات الماكرو الخاص بك. ومن بين هذه المكوّنات، هناك ثلاثة أنواع من المدخلات يمكنك استرجاع قيم منها:

• CheckBox
• EditText
• RadioGroup

للوصول إلى القيم من مكوّنات الإدخال هذه، يمكنك استخدام الدالة Dialog:getValueById() في منطق الماكرو الخاص بك. ومن خلال تحديد المعرّف الفريد للمكوّن، يمكنك استرداد إدخال المستخدم واستخدامه لتوجيه إجراءات الماكرو.

ملاحظة: يجب أن يكون لكل مكوّن في مربع الحوار معرّف فريد. ويضمن ذلك قدرة الماكرو على تحديد القيم واستردادها بشكل صحيح من المكوّن المحدد الذي تستهدفه. وقد تؤدي المعرّفات المكررة إلى حدوث ارتباك وأخطاء في تنفيذ الماكرو.