خيارات شائعة¶

تُصفر معظم الخيارات الشائعة قبل معالجة كل ودجة.

--ascii-lines

بدلاً من رسم خطوط رسومية حول الصناديق، تُرسم محارف ASCII مثل “+” و“-” في نفس المكان. انظر أيضًا “--no-lines”.

--aspect النسبة

يمنحك هذا بعض التحكم في أبعاد الصندوق عند استخدام التحجيم الآلي (بتحديد 0 للطول والعرض). تمثل النسبة العرض / الطول. القيمة المبدئية هي 9، مما يعني عرض 9 محارف لكل سطر واحد من الطول.

--backtitle العنوان_الخلفي

يحدد سلسلة العنوان_الخلفي لتُعرض على الخلفية، في الجزء العلوي من الشاشة.

--begin y x

حدد موضع الزاوية العلوية اليسرى لصندوق الحوار على الشاشة.

--cancel-label سلسلة

تجاوز التسمية المستخدمة لأزرار “إلغاء”.

--clear

يمسح شاشة الودجة، محتفظًا فقط بخلفية screen_color. استخدم هذا عند دمج الودجات مع “--and-widget” لمحو محتويات الودجة السابقة من الشاشة، حتى لا تظهر تحت محتويات الودجة التالية. افهم هذا كمكمل لـ “--keep-window”. لمقارنة التأثيرات، استخدم هذه:

جميع الودجات الثلاث مرئية، تأثير الدرج، مرتبة 1،2،3:

dialog \


                               --begin 2 2 --yesno "" 0 0 \


    --and-widget               --begin 4 4 --yesno "" 0 0 \


    --and-widget               --begin 6 6 --yesno "" 0 0

الودجة الأخيرة فقط تبقى مرئية:

dialog \


                 --clear       --begin 2 2 --yesno "" 0 0 \


    --and-widget --clear       --begin 4 4 --yesno "" 0 0 \


    --and-widget               --begin 6 6 --yesno "" 0 0

جميع الودجات الثلاث مرئية، تأثير الدرج، مرتبة 3،2،1:

dialog \


                 --keep-window --begin 2 2 --yesno "" 0 0 \


    --and-widget --keep-window --begin 4 4 --yesno "" 0 0 \


    --and-widget               --begin 6 6 --yesno "" 0 0

الودجتان الأولى والثالثة مرئيتان، تأثير الدرج، مرتبة 3،1:

dialog \


                 --keep-window --begin 2 2 --yesno "" 0 0 \


    --and-widget --clear       --begin 4 4 --yesno "" 0 0 \


    --and-widget               --begin 6 6 --yesno "" 0 0

لاحظ أنه إذا كنت ترغب في استعادة ألوان الطرفية الأصلية وإرسال المؤشر إلى مكانه المبدئي بعد خروج برنامج الحوار، فاستخدم الأمر clear(1). وعلى العكس من ذلك، إذا كنت ترغب في مسح الشاشة وإرسال المؤشر إلى الزاوية السفلية اليسرى بعد خروج برنامج dialog، فاستخدم خيار --erase-on-exit.

--color-mode الرمز

توسيع خيار --colors ليشمل محتوى programbox وtailbox وtextbox. استخدم الرمز “2” لهذه الميزة.

--colors

تفسير تسلسلات “\Z” المضمنة في نص الحوار بواسطة المحرف التالي، الذي يخبر dialog بضبط الألوان أو سمات الفيديو:

--column-separator سلسلة

إخبار dialog بتقسيم البيانات لصناديق الخيار/التحقق والقوائم عند ورود السلسلة المعطاة، ومحاذاة البيانات المقسمة في أعمدة.

--cr-wrap

تفسير الأسطر الجديدة المضمنة في نص الحوار كسطر جديد على الشاشة. وإلا، فسيقوم dialog بلف الأسطر فقط عند الحاجة لتناسب داخل صندوق النص.

على الرغم من أنه يمكنك التحكم في فواصل الأسطر بهذا، إلا أن Dialog سيظل يلف أي أسطر طويلة جدًا بالنسبة لعرض الصندوق. بدون cr-wrap، قد تُنسق بنية النص لتبدو جميلة في الكود المصدري لسكربتك دون التأثير على شكلها في الحوار.

تُنفذ ميزة cr-wrap وفقًا لهذه الشروط:

لمزيد من المعلومات، انظر Whitespace Options.

--create-rc ملف

عندما يدعم dialog التهيئة أثناء التشغيل، يمكن استخدام هذا لتفريغ ملف تهيئة عينة في الملف المحدد بواسطة ملف.

--cursor-off-label

وضع مؤشر الطرفية في نهاية الزر بدلاً من المحرف الأول لتسمية الزر. هذا مفيد لتقليل الارتباك البصري عندما يتداخل تلوين المؤشر بشكل سيء مع ألوان نص تسمية الزر.

--date-format تنسيق

إذا كان المضيف يوفر strftime، فإن هذا الخيار يسمح لك بتحديد تنسيق التاريخ المطبوع لودجة --calendar. وقت اليوم (الساعة، الدقيقة، الثانية) هو الوقت المحلي الحالي.

--defaultno

جعل القيمة المبدئية لصندوق نعم/لا هي لا. وبالمثل، معاملة الزر المبدئي للودجات التي توفر “موافق” و“إلغاء” كـ إلغاء. إذا أُعطي الخياران “--no-cancel” أو “--visit-items” فإنهما يتجاوزان هذا، مما يجعل الزر المبدئي دائمًا “نعم” (داخليًا هو نفسه “موافق”).

--default-button سلسلة

ضبط الزر المبدئي (المختار مسبقًا) في ودجة. باختيار زر مسبقًا، يتيح السكربت للمستخدم ببساطة الضغط على Enter للمضي قدمًا عبر الحوار بأقل قدر من التفاعل.

قيمة الخيار هي اسم الزر: ok، yes، cancel، no، help أو extra.

عادةً ما يكون الزر الأول في كل ودجة هو المبدئي. الزر الأول المعروض يتم تحديده بواسطة الودجة جنبًا إلى جنب مع خياري “--no-ok” و“--no-cancel”. إذا لم يُعطَ هذا الخيار، فلا يتم تعيين زر مبدئي.

--default-item سلسلة

ضبط العنصر المبدئي في صندوق التحقق، أو النموذج، أو القائمة. عادةً ما يكون العنصر الأول في الصندوق هو المبدئي.

--erase-on-exit

عند خروج dialog، تُزال ودجة الحوار، وتُمسح الشاشة بأكملها إلى لون خلفيتها الأصلي، ويُوضع مؤشر الطرفية في الزاوية السفلية اليسرى.

--exit-label سلسلة

تجاوز التسمية المستخدمة لأزرار “خروج”.

--extra-button

إظهار زر إضافي، بين أزرار “موافق” و“إلغاء”.

يظهر الزر الإضافي بين “نعم” و“لا” لودجة yesno.

--extra-label سلسلة

يتخطى التسمية المستخدمة لأزرار “إضافي”. ملاحظة: بالنسبة لودجات inputmenu، القيمة المبدئية هي “إعادة تسمية”.

--help

يطبع رسالة المساعدة إلى المخرج القياسي ثم يخرج. تُطبع رسالة المساعدة أيضًا إذا لم تُعطَ أي خيارات، أو إذا عُطِي خيار غير معروف.

--help-button

يظهر زر مساعدة بعد زرّي “موافق” و“إلغاء” في المربعات التي تحتوي قائمة عناصر موسومة (أي مربعات checklist وradiolist وmenu وtreeview).

يظهر زر المساعدة بعد “نعم” و“لا” في ودجة yesno.

عند الخروج، تشير حالة العودة إلى أنه ضُغط على زر المساعدة. يكتب Dialog أيضًا رسالة إلى مخرجه بعد العلامة “HELP”:

يمكنك استخدام الخيار --help-tags و/أو ضبط متغير البيئة DIALOG_ITEM_HELP لتعديل هذه الرسائل وحالة الخروج.

يمكن تطبيق هذا الخيار على الودجات الأخرى التي تحتوي زر “موافق”، سواء استُخدم زر “إلغاء” أم لا. لا تُعامل حالة العودة والمخرج معاملة خاصة للودجات الأخرى؛ زر المساعدة هو مجرد زر إضافي.

--help-label string

يتخطى التسمية المستخدمة لأزرار “مساعدة”.

--help-status

إذا اختُير زر المساعدة، يكتب معلومات checklist أو radiolist أو form بعد معلومات مساعدة العنصر “HELP”. يمكن استخدام هذا لإعادة بناء حالة قائمة الاختيار (checklist) بعد معالجة طلب المساعدة.

--help-tags

يعدل الرسائل المكتوبة عند الخروج للخيار --help-button بجعلها دائمًا مجرد وسم العنصر. لا يؤثر هذا على رمز حالة الخروج.

--hfile filename

يعرض الملف المعطى باستخدام مربع نص عندما يضغط المستخدم على F1.

--hline string

يعرض السلسلة المعطاة ممركزة في أسفل الودجة.

--ignore

يتجاهل الخيارات التي لا يتعرف عليها dialog. تُتجاهل بعض الخيارات المعروفة مثل “--icon” على أي حال، ولكن هذا خيار أفضل للتوافق مع التطبيقات الأخرى.

--input-fd fd

يقرأ مدخلات لوحة المفاتيح من واصف الملف المعطى. تقرأ معظم سكريبتات dialog من المدخل القياسي، لكن ودجة gauge تقرأ أنبوبًا (والذي هو دائمًا المدخل القياسي). بعض الإعدادات لا تعمل بشكل صحيح عندما يحاول dialog إعادة فتح الطرفية. استخدم هذا الخيار (مع التلاعب المناسب بواصفات الملفات) إذا كان سكريبتك يجب أن يعمل في هذا النوع من البيئات.

--insecure

يجعل ودجة كلمة المرور أكثر ودية ولكن أقل أمانًا، عبر إظهار نجوم لكل حرف.

--iso-week

يضبط نقطة البداية لرقم الأسبوع المعروض في خيار “--calendar” وفقًا للمعيار ISO-8601، الذي يبدأ الترقيم بأول أسبوع يتضمن يوم خميس في شهر كانون الثاني/يناير.

--item-help

يفسر بيانات الأوسمة لمربعات checklist وradiolist وmenu مضيفًا عمودًا يُعرض في السطر السفلي من الشاشة للعنصر المحدد حاليًا.

--keep-tite

عند بنائه باستخدام ncurses، يتحقق dialog عادةً مما إذا كان يعمل في xterm، وفي هذه الحالة يحاول كبح سلاسل التهيئة التي ستجعله ينتقل إلى الشاشة البديلة. التبديل بين الشاشات العادية والبديلة مشتت بصريًا في سكريبت يشغل dialog عدة مرات. استخدم هذا الخيار للسماح لـ dialog باستخدام سلاسل التهيئة تلك.

--keep-window

عادةً عندما ينفذ dialog عدة ودجات tailboxbg متصلة بـ “--and-widget”، فإنه يمسح الودجة القديمة من الشاشة بالرسم فوقها. استخدم هذا الخيار لكبح إعادة الرسم تلك.

عند الخروج، يعيد dialog رسم جميع الودجات التي عُلّمت بـ “--keep-window”، حتى لو لم تكن ودجات tailboxbg. يؤدي ذلك إلى إعادة رسمها بترتيب عكسي. راجع نقاش خيار “--clear” للحصول على أمثلة.

--last-key

عند الخروج، يبلغ عن آخر مفتاح أدخله المستخدم. هذا هو رمز مفتاح curses وليس رمزًا أو حرفًا حرفيًا، ويُبلغ عنه فقط للمفاتيح المرتبطة بإجراء ما. يمكن استخدامه بواسطة السكريبتات للتمييز بين مفتاحين مرتبطين بنفس الإجراء.

--max-input size

يحد سلاسل الإدخال بالحجم المعطى. إذا لم يُحدد، فالحد هو 2048.

--no-cancel

يكبح زر “إلغاء” في أوضاع checklist وinputbox وmenu. لا يزال بإمكان السكريبت اختبار ما إذا كان المستخدم قد ضغط على مفتاح ESC للإلغاء للخروج.

--no-collapse

عادةً ما يحول dialog علامات الجدولة إلى مسافات ويقلص المسافات المتعددة إلى مسافة واحدة للنص المعروض في مربعات الرسائل، وما إلى ذلك. استخدم هذا الخيار لتعطيل هذه الميزة. لاحظ أن dialog سيظل يلف النص، مع مراعاة الخيارين “--cr-wrap” و“--trim”.

تُطبق ميزة no-collapse وفقًا لهذه الشروط:

لمزيد من المعلومات، انظر Whitespace Options.

--no-hot-list

يخبر dialog بكبح ميزة مفاتيح الاختصار للقوائم، مثل checkbox وmenus.

عادةً، يُبرز أول حرف كبير في مدخل القائمة، ويؤدي كتابة هذا الحرف إلى نقل التركيز إلى ذلك المدخل. يكبح هذا الخيار كلاً من الإبراز والحركة.

لا تتأثر مفاتيح الاختصار للأزرار (“موافق” ، “إلغاء”، إلخ).

--no-items

تعرض بعض الودجات (checklist وinputmenu وradiolist وmenu) قائمة من عمودين (“وسم” و“عنصر”، أي “وصف”). يخبر هذا الخيار dialog بقراءة صفوف أقصر، مع حذف جزء “العنصر” من القائمة. هذا مفيد أحيانًا، على سبيل المثال، إذا كانت الأوسمة توفر معلومات كافية.

راجع أيضًا --no-tags. إذا عُطي كلا الخيارين، فسيُتجاهل هذا الخيار.

--no-kill

يخبر dialog بوضع مربع tailboxbg في الخلفية، مع طباعة معرّف العملية الخاص به إلى مخرج dialog. تُعطل إشارة SIGHUP لعملية الخلفية.

--no-label string

يتخطى التسمية المستخدمة لأزرار “لا”.

--no-lines

بدلاً من رسم خطوط حول المربعات، تُرسم مسافات في نفس المكان. راجع أيضًا “--ascii-lines”.

--no-mouse

لا يفعّل الفأرة.

--no-nl-expand

لا يحول السلاسل الفرعية “\n” في نص الرسالة/المطالبة إلى أسطر جديدة حرفية.

تُستخدم ميزة no-nl-expand فقط إذا كانت السلسلة تحتوي على “\n” بحيث يكون هناك شيء لتحويله.

لمزيد من المعلومات، انظر Whitespace Options.

--no-ok

يكبح زر “موافق”، بحيث لا يُعرض. لا يزال بإمكان السكريبت اختبار ما إذا كان المستخدم قد ضغط على مفتاح “Enter” لقبول البيانات:

--no-shadow

يكبح الظلال التي ستُرسم على يمين وأسفل كل مربع حوار.

--no-tags

تعرض بعض الودجات (checklist وinputmenu وradiolist وmenu) قائمة من عمودين (“وسم” و“وصف”). الوسم مفيد للسكريبتات، لكنه قد لا يساعد المستخدم. يمكن استخدام الخيار --no-tags (من Xdialog) لكبح عمود الأوسمة من العرض. وعلى عكس الخيار --no-items، لا يؤثر هذا على البيانات التي تُقرأ من السكريبت.

لا يعرض Xdialog عمود الأوسمة لودجات buildlist وtreeview المماثلة؛ ويفعل dialog الشيء نفسه.

عادةً ما يسمح لك dialog بالانتقال بسرعة إلى المدخلات في القائمة المعروضة، عبر مطابقة حرف واحد مع الحرف الأول من الوسم. عند إعطاء الخيار --no-tags، يطابق dialog مع الحرف الأول من الوصف. في كلتا الحالتين، يُبرز الحرف القابل للمطابقة.

--ok-label string

يتخطى التسمية المستخدمة لأزرار “موافق”.

--output-fd fd

يوجه المخرج إلى واصف الملف المعطى. تكتب معظم سكريبتات dialog إلى الخطأ القياسي، ولكن قد تُكتب رسائل الخطأ هناك أيضًا، اعتمادًا على سكريبتك.

--separator string

--output-separator string

يحدد سلسلة ستفصل المخرجات في مخرج dialog من قوائم الاختيار (checklists)، بدلاً من سطر جديد (للخيار --separate-output) أو مسافة. ينطبق هذا على الودجات الأخرى مثل النماذج (forms) وصناديق التحرير (editboxes) التي تستخدم عادةً سطرًا جديدًا.

--print-maxsize

يطبع الحجم الأقصى لمربعات الحوار، أي حجم الشاشة، إلى مخرج dialog. يمكن استخدام هذا بمفرده، دون خيارات أخرى.

--print-size

يطبع حجم كل مربع حوار إلى مخرج dialog عند تهيئة المربع.

--print-text-only string [ height [ width ] ]

يطبع السلسلة كما لو كانت ملفوفة في مربع رسالة إلى مخرج dialog.

لأن قيمتي height وwidth الاختياريتين تكونان صفرًا مبدئيًا، فإنه إذا حُذفتا، فسيقوم dialog بالتحجيم الآلي وفقًا لأبعاد الشاشة.

--print-text-size string [ height [ width ] ]

يطبع حجم السلسلة كما لو كانت ملفوفة في مربع رسالة، إلى مخرج dialog، كالتالي

الارتفاع العرض

لأن معاملي height وwidth الاختياريين يكونان صفرًا مبدئيًا، فإنه إذا حُذفا، فسيقوم dialog بالتحجيم الآلي وفقًا لأبعاد الشاشة.

--print-version

يطبع إصدار dialog إلى مخرج dialog. يمكن استخدام هذا بمفرده، دون خيارات أخرى. ولا يتسبب في خروج dialog تلقائيًا.

--quoted

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

--reorder

افتراضيًا، تستخدم ودجة buildlist نفس الترتيب لقائمة المخرجات (اليمنى) كما هو في قائمة المدخلات (اليسرى). استخدم هذا الخيار لإخبار dialog باستخدام الترتيب الذي يضيف به المستخدم التحديدات إلى قائمة المخرجات.

--scrollbar

بالنسبة للودجات التي تحتوي على مجموعة بيانات قابلة للتمرير، يرسم شريط تمرير على هامشها الأيمن. لا يستجيب هذا الشريط للفأرة.

--separate-output

بالنسبة لودجات معينة (buildlist، وchecklist، وtreeview)، تُخرَج النتيجة سطرا تلو الآخر، دون اقتباس. يسهل هذا التحليل بواسطة برنامج آخر.

--separate-widget سلسلة

حدد سلسلة تفصل بين مخرجات كل ودجة في مخرجات dialog. يُستخدم هذا لتبسيط تحليل نتيجة حوار يضم عدة ودجات. إذا لم يُعطَ هذا الخيار، فإن سلسلة الفصل المبدئية هي علامة جدولة (tab).

--single-quoted

استخدم الاقتباس المفرد حسب الحاجة (ولا تستخدم اقتباسات إذا لم تكن هناك حاجة) لمخرجات قائمة التحقق (checklist) وكذلك نص مساعدة العناصر.

إذا لم يُضبط هذا الخيار، فقد يستخدم dialog علامات اقتباس مزدوجة حول كل عنصر. في كلتا الحالتين، يضيف dialog مائلات خلفية لجعل المخرجات مفيدة في سكربتات الصدفة.

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

--size-err

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

--sleep ثوانٍ

توقف (تأخر) لعدد الثواني المعطى بعد معالجة صندوق الحوار.

--stderr

وجّه المخرجات إلى الخطأ القياسي. هذا هو المبدئي، لأن curses يكتب تحديثات الشاشة عادةً إلى المخرجات القياسية.

--stdout

وجّه المخرجات إلى المخرجات القياسية. وُفر هذا الخيار للتوافق مع Xdialog، ومع ذلك لا يُنصح باستخدامه في السكربتات المنقولة، لأن curses يكتب عادةً تحديثات الشاشة إلى المخرجات القياسية. إذا استخدمت هذا الخيار، سيحاول dialog إعادة فتح الطرفية ليتمكن من الكتابة إلى العرض. قد يفشل ذلك بناءً على المنصة وبيئتك.

--tab-correct

حول كل علامة جدولة (tab) إلى مسافة واحدة أو أكثر (لودجة textbox؛ وإلا فإلى مسافة واحدة). بخلاف ذلك، تُصيّر علامات الجدولة وفقاً لتفسير مكتبة curses. يعطل خيار --no-collapse توسيع علامات الجدولة.

--tab-len n

حدد عدد المسافات التي تحتلها علامة الجدولة إذا أُعطي خيار “--tab-correct”. القيمة المبدئية هي 8. هذا الخيار فعال فقط لودجة textbox.

--time-format تنسيق

إذا كان المضيف يوفر strftime، يتيح لك هذا الخيار تحديد تنسيق الوقت المطبوع لودجة --timebox. قيم اليوم والشهر والسنة في هذه الحالة تكون للوقت المحلي الحالي.

--timeout ثوانٍ

تنتهي المهلة إذا لم يستجب المستخدم خلال عدد الثواني المعطى. تُتجاهل المهلة التي تبلغ صفر ثانية.

عادةً ما تؤدي المهلة إلى إدخال محرف ESC في الودجة الحالية، مما يلغيها. قد تظل ودجات أخرى على الشاشة؛ وهذه لا تُلحى. اضبط متغير البيئة DIALOG_TIMEOUT لإخبار dialog بالخروج مباشرة بدلاً من ذلك، أي إلغاء جميع الودجات على الشاشة.

يُتجاهل هذا الخيار بواسطة ودجة “--pause”. كما يتم تخطيه إذا استُخدم خيار الخلفية “--tailboxbg” لإعداد عدة ودجات متزامنة.

--title عنوان

يحدد سلسلة عنوان لتعرض في أعلى صندوق الحوار.

--trace اسم_الملف

يسجل معاملات سطر الأوامر، وضغطات المفاتيح والمعلومات الأخرى في الملف المعطى. إذا قرأ dialog ملف إعداد، فيُسجل أيضاً. تُسجل المدخلات الموجهة إلى ودجة gauge. استخدم control/T لتسجيل صورة لنافذة الحوار الحالية.

يتعامل برنامج dialog مع بعض معاملات سطر الأوامر بشكل خاص، ويزيلها من قائمة المعاملات أثناء معالجتها. على سبيل المثال، إذا كان الخيار الأول هو --trace، فإنه يُعالج (ويُزال) قبل أن يهيئ dialog العرض.

--week-start يوم

يضبط يوم بداية الأسبوع، المُستخدم في خيار “--calendar”. يمكن أن يكون معامل اليوم:

--trim

إزالة الفراغات البادئة، وتشذيب أسطر السطر الجديدة الحرفية والفراغات المتكررة من نص الرسالة.

تُنفذ ميزة التشذيب وفقاً لهذه الشروط:

لمزيد من المعلومات، انظر Whitespace Options.

انظر أيضاً خياري “--cr-wrap” و “--no-collapse”.

--version

يطبع إصدار dialog إلى المخرجات القياسية، ويخرج. انظر أيضاً “--print-version”.

--visit-items

عدل التنقل بجدولة (tab-traversal) لكل من checklist وradiolist وmenubox وinputmenu لتشمل قائمة العناصر كإحدى الحالات. هذا مفيد كمساعدة بصرية، أي أن موضع المؤشر يساعد بعض المستخدمين.

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

--yes-label سلسلة

تخطي اللصيقة المستخدمة لأزرار “نعم” (Yes).

خيارات الصندوق¶

تحتوي جميع صناديق الحوار على ثلاثة معاملات على الأقل:

text

تسمية أو محتويات الصندوق.

height

ارتفاع صندوق الحوار.

width

عرض صندوق الحوار.

تعتمد المعاملات الأخرى على نوع الصندوق.

--buildlist النص الارتفاع العرض ارتفاع_القائمة [ الوسم العنصر الحالة ] ...

يعرض حوار buildlist قائمتين جنباً إلى جنب. تظهر القائمة على اليسار العناصر غير المحددة. وتظهر القائمة على اليمين العناصر المحددة. تنتقل العناصر بين القائمتين عند تحديدها أو إلغاء تحديدها.

استخدم زر الرجوع (carriage return) أو زر “موافق” لقبول القيمة الحالية في نافذة المحددة والخروج. تُكتب النتائج باستخدام الترتيب المعروض في النافذة المحددة.

تُحدد حالة التشغيل/الإيقاف المبدئية لكل إدخال بواسطة الحالة.

يتصرف الحوار مثل menu، مستخدماً --visit-items للتحكم فيما إذا كان يُسمح للمؤشر بزيارة القوائم مباشرة.

سواء أُعطي خيار --visit-items أم لا، فمن الممكن نقل التمييز بين القائمتين باستخدام المفاتيح المبدئية “^” (العمود الأيسر) و “$” (العمود الأيمن).

عند الخروج، ستُطبع قائمة بسلاسل الوسم لتلك الإدخالات التي تم تشغيلها على مخرجات dialog.

إذا لم يُعطَ خيار "--separate-output"، فستُقتبس السلاسل حسب الحاجة لجعل فصلها بسيطاً للسكربتات. بشكل مبدئي، يستخدم هذا علامات اقتباس مزدوجة، حسب الحاجة. انظر خيار “--single-quoted”، الذي يعدل سلوك الاقتباس.

--calendar النص الارتفاع العرض اليوم الشهر السنة

يعرض صندوق التقويم الشهر واليوم والسنة في نوافذ قابلة للضبط بشكل منفصل. إذا كانت قيم اليوم أو الشهر أو السنة مفقودة أو سالبة، تُستخدم القيم المقابلة للتاريخ الحالي. يمكنك زيادة أو تقليل أي منها باستخدام الأسهم لليسار، ولأعلى، ولليمين، ولأسفل. استخدم h وj وk وl بأسلوب vi للتنقل في مصفوفة أيام الشهر. استخدم جدولة (tab) أو جدولة خلفية (backtab) للتنقل بين النوافذ. إذا أُعطيت السنة كصفر، يُستخدم التاريخ الحالي كقيمة مبدئية.

عند الخروج، يُطبع التاريخ بصيغة يوم/شهر/سنة. يمكن تخطي التنسيق باستخدام خيار --date-format.

--checklist النص الارتفاع العرض ارتفاع_القائمة [ الوسم العنصر الحالة ] ...

صندوق قائمة التحقق checklist يشبه صندوق القائمة menu؛ حيث توجد عدة إدخالات معروضة في شكل قائمة. فرق آخر هو أنه يمكنك الإشارة إلى الإدخال المحدد حالياً عن طريق ضبط حالته لتكون on. بدلاً من اختيار إدخال واحد من بين الإدخالات، يمكن للمستخدم تشغيل أو إيقاف كل إدخال. تُحدد حالة التشغيل/الإيقاف المبدئية لكل إدخال بواسطة الحالة.

عند الخروج، ستُطبع قائمة بسلاسل الوسم لتلك الإدخالات التي تم تشغيلها على مخرجات dialog.

إذا لم يُعطَ خيار “--separate-output”، فستُقتبس السلاسل حسب الحاجة لجعل فصلها بسيطاً للسكربتات. بشكل مبدئي، يستخدم هذا علامات اقتباس مزدوجة (حسب الحاجة). انظر خيار “--single-quoted”، الذي يعدل سلوك الاقتباس.

--dselect مسار_الملف الارتفاع العرض

يعرض حوار اختيار الدليل نافذة لإدخال النص يمكنك من خلالها كتابة اسم دليل، وفوقها نافذة بأسماء الأدلة.

هنا يمكن أن يكون filepath مسار ملف، وفي هذه الحالة ستعرض نافذة الدليل محتويات المسار وستحتوي نافذة إدخال النص على الدليل المحدد مسبقاً.

استخدم مفتاح الجدولة (tab) أو مفاتيح الأسهم للتنقل بين النوافذ. داخل نافذة الدليل، استخدم مفتاحي السهم لأعلى/لأسفل للتمرير في التحديد الحالي. استخدم مفتاح المسافة لنسخ التحديد الحالي إلى نافذة إدخال النص.

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

استخدم زر الرجوع (carriage return) أو زر “موافق” لقبول القيمة الحالية في نافذة إدخال النص والخروج.

عند الخروج، تُكتب محتويات نافذة إدخال النص إلى مخرجات dialog.

--editbox مسار_الملف الارتفاع العرض

يعرض حوار صندوق التحرير نسخة من الملف. يمكنك تحريره باستخدام مفاتيح backspace وdelete ومفاتيح المؤشر لتصحيح أخطاء الكتابة. كما أنه يتعرف على pageup/pagedown. بخلاف --inputbox، يجب أن تنتقل بالجدولة إلى زر “موافق” أو “إلغاء” لإغلاق الحوار. سيؤدي الضغط على مفتاح “إدخال” داخل الصندوق إلى تقسيم السطر المقابل.

عند الخروج، تُكتب محتويات نافذة التحرير إلى مخرجات dialog.

--form النص الارتفاع العرض ارتفاع_النموذج [ اللصيقة ص س العنصر ص س طول_الحقل طول_الإدخال ] ...

يعرض حوار النموذج form نموذجاً يتكون من لصائق وحقول، يتم وضعها على نافذة قابلة للتمرير بواسطة إحداثيات معطاة في السكربت. يحدد طول الحقل flen وطول الإدخال ilen مدى طول الحقل. يحدد الأول الطول المعروض للحقل المحدد، بينما يحدد الأخير الطول المسموح به للبيانات المدخلة في الحقل.

استخدم السهمين لأعلى/لأسفل (أو control/N، وcontrol/P) للتنقل بين الحقول. استخدم الجدولة (tab) للتنقل بين النوافذ.

عند الخروج، تُكتب محتويات حقول النموذج إلى مخرجات dialog، مع فصل كل حقل بسطر جديد. لا يُكتب النص المستخدم لملء الحقول غير القابلة للتحرير (عندما يكون flen صفراً أو سالباً).

--fselect مسار_الملف الارتفاع العرض

يعرض حوار fselect (اختيار الملفات) نافذة لإدخال النص يمكنك من خلالها كتابة اسم ملف (أو دليل)، وفوقها نافذتان بأسماء الأدلة وأسماء الملفات.

هنا يمكن أن يكون filepath مسار ملف، وفي هذه الحالة ستعرض نافذتا الملف والدليل محتويات المسار وستحتوي نافذة إدخال النص على اسم الملف المحدد مسبقاً.

استخدم مفتاح الجدولة (tab) أو مفاتيح الأسهم للتنقل بين النوافذ. داخل نوافذ الدليل أو اسم الملف، استخدم مفتاحي السهم لأعلى/لأسفل للتمرير في التحديد الحالي. استخدم مفتاح المسافة لنسخ التحديد الحالي إلى نافذة إدخال النص.

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

يؤدي كتابة محرف المسافة إلى إجبار dialog على إكمال الاسم الحالي (حتى النقطة التي قد يكون فيها تطابق مع أكثر من إدخال واحد).

استخدم زر الرجوع (carriage return) أو زر “موافق” لقبول القيمة الحالية في نافذة إدخال النص والخروج.

عند الخروج، تُكتب محتويات نافذة إدخال النص إلى مخرجات dialog.

--gauge النص الارتفاع العرض [نسبة_مئوية]

يعرض صندوق gauge مقياسًا أسفل الصندوق. يشير المقياس إلى النسبة المئوية. تُقرأ النسب المئوية الجديدة من الدخل القياسي، عدد صحيح واحد لكل سطر. يُحدّث المقياس ليعكس كل نسبة مئوية جديدة. إذا قرأ الدخل القياسي السلسلة “XXX”، فإن السطر الأول التالي يُتخذ كنسبة مئوية صحيحة، ثم تُستخدم الأسطر اللاحقة حتى ظهور “XXX” أخرى كمحلق جديد. يخرج المقياس عند الوصول إلى نهاية الملف (EOF) في الدخل القياسي.

تشير قيمة percent إلى النسبة المئوية الأولية المعروضة في العداد. إذا لم تُحدد، فستكون صفرًا.

عند الخروج، لا يُكتب أي نص في مخرجات dialog. لا تقبل الودجت أي مدخلات، لذا فإن حالة الخروج هي «موافق» دائمًا.

--infobox النص الارتفاع العرض

صندوق info هو في الأساس صندوق رسالة. ومع ذلك، في هذه الحالة، سيخرج dialog فور عرض الرسالة للمستخدم. لا تُمسح الشاشة عند خروج dialog، لكي تبقى الرسالة على الشاشة حتى تمسحها صدفة (shell) المستدعِي لاحقًا. وهذا مفيد عندما تريد إبلاغ المستخدم بأن بعض العمليات جارية وقد تتطلب بعض الوقت للانتهاء.

عند الخروج، لا يُكتب أي نص في مخرجات dialog. وتُعاد حالة خروج «موافق».

--inputbox النص الارتفاع العرض [التهيئة]

يعد صندوق المدخلات مفيدًا عندما تريد طرح أسئلة تتطلب من المستخدم إدخال سلسلة نصية كإجابة. إذا وُفرت قيمة التهيئة (init)، فستُستخدم لتهيئة سلسلة المدخلات. عند إدخال السلسلة، يمكن استخدام مفاتيح backspace و delete ومفاتيح الأسهم لتصحيح الأخطاء المطبعية. إذا كانت سلسلة المدخلات أطول مما يتسع له صندوق الحوار، فسيُمرر حقل الإدخال.

عند الخروج، ستُطبع سلسلة المدخلات على مخرجات dialog.

--inputmenu النص الارتفاع العرض ارتفاع-القائمة [ وسم عنصر ] ...

صندوق inputmenu مشابه جدًا لصندوق القائمة العادي. لا يوجد سوى فروق قليلة بينهما:

--menu text height width menu-height [ tag item ] ...

كما يوحي اسمه، صندوق menu هو صندوق حوار يمكن استخدامه لعرض قائمة خيارات على شكل قائمة ليختار منها المستخدم. تُعرض الخيارات بالترتيب المعطى. يتكون كل إدخال في القائمة من سلسلة وسم وسلسلة عنصر. يعطي الوسم للإدخال اسمًا لتمييزه عن الإدخالات الأخرى في القائمة. أما العنصر فهو وصف قصير للخيار الذي يمثله الإدخال. يمكن للمستخدم التنقل بين إدخالات القائمة بالضغط على مفاتيح المؤشر، أو الحرف الأول من الوسم كمفتاح اختصار، أو مفاتيح الأرقام من 1 إلى 9. تُعرض إدخالات بعدد menu-height في القائمة في المرة الواحدة، ولكن ستُمرر القائمة إذا كان هناك مدخلات أكثر من ذلك.

عند الخروج، يُطبع وسم إدخال القائمة المختار على خرج dialog. إذا أُعطي الخيار “--help-button”، فسيُطبع نص المساعدة المقابل إذا اختار المستخدم زر المساعدة.

--mixedform text height width formheight [ label y x item y x flen ilen itype ] ...

يعرض حوار mixedform نموذجًا يتكون من لصائق وحقول، تمامًا مثل حوار --form. ويختلف عنه بإضافة معامل نوع الحقل إلى وصف كل حقل. تشير كل بتة في النوع إلى سمة للحقل:

--mixedgauge النص الارتفاع العرض النسبة [ الوسم1 العنصر1 ] ...

يعرض صندوق mixedgauge مقياسًا أسفل الصندوق. يشير المقياس إلى النسبة المئوية.

يعرض أيضًا قائمة بقيم الوسم و العنصر في أعلى الصندوق. انظر dialog(3) لقيم الوسوم.

يُعرض النص كعنوان بين القائمة والمقياس. تشير قيمة النسبة إلى النسبة المئوية الأولية المعروضة في المقياس.

لا يوجد توفير لقراءة البيانات من الدخل القياسي كما يفعل --gauge.

عند الخروج، لا يُكتب أي نص في مخرجات dialog. لا تقبل الودجت أي مدخلات، لذا فإن حالة الخروج هي «موافق» دائمًا.

--msgbox text height width

صندوق message مشابه جدًا لصندوق yes/no. الفرق الوحيد بينهما هو أن صندوق message يحتوي فقط على زر موافق واحد. يمكنك استخدام صندوق الحوار هذا لعرض أي رسالة تريدها. بعد قراءة الرسالة، يمكن للمستخدم الضغط على مفتاح ENTER ليخرج dialog وتكمل سكربت الصدفة المستدعِي عملها.

إذا كانت الرسالة كبيرة جدًا على المساحة، فقد يسمح لك dialog بتمريرها، بشرط أن يكون تنفيذ curses الأساسي قادرًا على ذلك. في هذه الحالة، تُعرض نسبة مئوية في قاعدة الأداة.

عند الخروج، لا يُكتب أي نص على خرج dialog. يُوفر زر “موافق” فقط للدخل، ولكن قد تُرجع حالة خروج ESC.

--pause text height width seconds

يعرض صندوق pause مقياسًا أسفل الصندوق. يشير المقياس إلى عدد الثواني المتبقية حتى نهاية الفاصل الزمني. يخرج الفاصل الزمني عند انتهاء الوقت أو ضغط المستخدم على زر موافق (حالة OK) أو ضغط المستخدم على زر إلغاء أو مفتاح Esc.

--passwordbox text height width [init]

صندوق password مشابه لصندوق الإدخال، باستثناء أن النص الذي يدخله المستخدم لا يُعرض. هذا مفيد عند طلب كلمات السر أو معلومات حساسة أخرى. كن على علم بأنه إذا مُرر أي شيء في “init”، فسيكون مرئيًا في جدول عمليات النظام للمتطفلين العاديين. أيضًا، من المربك جدًا للمستخدم تزويده بكلمة سر مبدئية لا يمكنه رؤيتها. لهذه الأسباب، يُنصح بشدة بعدم استخدام “init”. انظر “--insecure” إذا كنت لا تهتم بكلمة سرك.

عند الخروج، ستُطبع سلسلة المدخلات على مخرجات dialog.

--passwordform text height width formheight [ label y x item y x flen ilen ] ...

هذا مطابق لـ --form باستثناء أن جميع حقول النص تُعامل كأدوات password بدلاً من أدوات inputbox.

--prgbox text command height width

--prgbox command height width

صندوق prgbox مشابه جدًا لصندوق programbox.

يُستخدم صندوق الحوار هذا لعرض خرج أمر مُحدد كمعامل لـ prgbox.

بعد اكتمال الأمر، يمكن للمستخدم الضغط على مفتاح ENTER ليخرج dialog وتكمل سكربت الصدفة المستدعية عملها.

إذا أُعطيت أربعة معاملات، فسيُعرض النص تحت العنوان، مفصولاً عن محتويات الملف المتحرك. إذا أُعطيت ثلاثة معاملات فقط، فسيُحذف هذا النص.

--programbox text height width

--programbox height width

صندوق programbox مشابه جدًا لصندوق progressbox. الفرق الوحيد بينهما هو أن صندوق program يعرض زر موافق (ولكن فقط بعد اكتمال الأمر).

يُستخدم صندوق الحوار هذا لعرض الخرج المنقول لأمر ما. بعد اكتمال الأمر، يمكن للمستخدم الضغط على مفتاح ENTER ليخرج dialog وتكمل سكربت الصدفة المستدعية عملها.

إذا أُعطيت ثلاثة معاملات، فسيُعرض النص تحت العنوان، مفصولاً عن محتويات الملف المتحرك. إذا أُعطيت معاملين فقط، فسيُحذف هذا النص.

--progressbox text height width

--progressbox height width

صندوق progressbox مشابه لـ tailbox، باستثناء أن

إذا أُعطيت ثلاثة معاملات، فسيُعرض النص تحت العنوان، مفصولاً عن محتويات الملف المتحرك. إذا أُعطيت معاملين فقط، فسيُحذف هذا النص.

--radiolist text height width list-height [ tag item status ] ...

صندوق radiolist مشابه لصندوق menu. الفرق الوحيد هو أنه يمكنك تحديد الإدخال المختار حاليًا بضبط حالته لتكون on.

عند الخروج، يُكتب وسم العنصر المختار في خرج dialog.

--rangebox text height width min-value max-value default-value

السماح للمستخدم بالاختيار من نطاق من القيم، مثلاً باستخدام شريط منزلق. يعرض الحوار القيمة الحالية كشريط (مثل حوار gauge). تحرك مفاتيح Tab أو الأسهم المؤشر بين الأزرار والقيمة. عندما يكون المؤشر على القيمة، يمكنك تعديلها عن طريق:

تُعرف بعض المفاتيح أيضًا في جميع مواضع المؤشر:

--tailbox file height width

عرض نص من ملف في صندوق حوار، كما في أمر “tail -f”. التمرير يسارًا/يمينًا باستخدام 'h' و 'l' بأسلوب vi، أو مفاتيح الأسهم. '0' يعيد ضبط التمرير.

عند الخروج، لا يُكتب أي نص على خرج dialog. يُوفر زر “موافق” فقط للدخل، ولكن قد تُرجع حالة خروج ESC.

--tailboxbg file height width

عرض نص من ملف في صندوق حوار كمهمة خلفية، كما في أمر “tail -f &”. التمرير يسارًا/يمينًا باستخدام 'h' و 'l' بأسلوب vi، أو مفاتيح الأسهم. '0' يعيد ضبط التمرير.

يعامل Dialog المهمة الخلفية بشكل خاص إذا كان هناك أدوات أخرى (--and-widget) على الشاشة في نفس الوقت. حتى تُغلق تلك الأدوات (مثلاً “موافق”)، سيقوم dialog بتشغيل جميع أدوات tailboxbg في نفس العملية، مع فحص التحديثات. يمكنك استخدام tab للتنقل بين الأدوات على الشاشة، وإغلاقها بشكل فردي، مثلاً بالضغط على ENTER. بمجرد إغلاق الأدوات التي ليست tailboxbg، يتفرع dialog بنسخة من نفسه إلى الخلفية، ويطبع معرف العملية الخاص به إذا أُعطي الخيار “--no-kill”.

عند الخروج، لا يُكتب أي نص في خرج dialog. يُوفر فقط زر “خروج” للدخل، ولكن قد تُرجع حالة خروج ESC.

ملاحظة: الإصدارات الأقدم من dialog كانت تتفرع فورًا وتحاول تحديث الشاشة بشكل فردي. بالإضافة إلى كون ذلك سيئًا للأداء، فقد كان غير عملي. بعض السكربتات القديمة قد لا تعمل بشكل صحيح مع نظام الفحص (polled) هذا.

--textbox file height width

يتيح لك صندوق text عرض محتويات ملف نصي في صندوق حوار. إنه مثل عارض ملفات نصية بسيط. يمكن للمستخدم التنقل خلال الملف باستخدام المؤشر، ومفاتيح page-up، و page-down، و HOME/END المتوفرة في معظم لوحات المفاتيح. إذا كانت الأسطر طويلة جدًا ليتم عرضها في الصندوق، يمكن استخدام مفتاحي اليسار/اليمين لتمرير منطقة النص أفقيًا. يمكنك أيضًا استخدام مفاتيح h و j و k و l بأسلوب vi بدلاً من مفاتيح المؤشر، و B أو N بدلاً من مفتاحي page-up و page-down. التمرير للأعلى/الأسفل باستخدام 'k' و 'j' بأسلوب vi، أو مفاتيح الأسهم. التمرير لليسار/اليمين باستخدام 'h' و 'l' بأسلوب vi، أو مفاتيح الأسهم. '0' يعيد ضبط التمرير لليسار/اليمين. ولمزيد من الراحة، تتوفر أيضًا وظائف بحث للأمام وللخلف بأسلوب vi.

عند الخروج، لا يُكتب أي نص في خرج dialog. يُوفر فقط زر “خروج” للدخل، ولكن قد تُرجع حالة خروج ESC.

--timebox text height [width hour minute second]

يُعرض حوار يسمح لك باختيار الساعة والدقيقة والثانية. إذا كانت قيم الساعة أو الدقيقة أو الثانية مفقودة أو سالبة، تُستخدم القيم المقابلة للتاريخ الحالي. يمكنك زيادة أو نقصان أي منها باستخدام أسهم اليسار والأعلى واليمين والأسفل. استخدم tab أو backtab للتنقل بين النوافذ.

عند الخروج، تُطبع النتيجة بصيغة ساعة:دقيقة:ثانية. يمكن تجاوز هذه الصيغة باستخدام خيار --time-format.

--treeview text height width list-height [ tag item status depth ] ...

عرض بيانات منظمة كشجرة. تحتوي كل مجموعة من البيانات على وسم، والنص المراد عرضه للعنصر، وحالته (“on” أو “off”) وعمق العنصر في الشجرة.

يمكن اختيار عنصر واحد فقط (مثل radiolist). لا يُعرض الوسم.

عند الخروج، يُكتب وسم العنصر المختار في خرج dialog.

--yesno text height width

سيُعرض صندوق حوار yes/no بحجم الارتفاع صفوف في العرض أعمدة. تُعرض السلسلة المحددة بواسطة النص داخل صندوق الحوار. إذا كانت هذه السلسلة طويلة جدًا بحيث لا تسعها سطر واحد، فسيتم تقسيمها آليًا إلى أسطر متعددة في الأماكن المناسبة. يمكن أن يحتوي النص أيضًا على السلسلة الفرعية "\n" أو محارف سطر جديد `\n' للتحكم في كسر الأسطر صراحةً. صندوق الحوار هذا مفيد لطرح أسئلة تتطلب من المستخدم الإجابة بنعم أو لا. يحتوي صندوق الحوار على زر نعم وزر لا، يمكن للمستخدم التبديل بينهما بالضغط على مفتاح TAB.

عند الخروج، لا يُكتب أي نص في خرج dialog. بالإضافة إلى رموز الخروج لـ “نعم” و “لا” (انظر التشخيصات)، قد تُرجع حالة خروج ESC.

تطابق الرموز المستخدمة لـ “نعم” و “لا” تلك المستخدمة لـ “موافق” و “إلغاء”)، داخليًا لا يوجد فرق بينها.

خيارات مهجورة¶

--beep

كان هذا يُستخدم لإخبار cdialog الأصلي بضرورة إصدار صوت تنبيه عندما تقوم العمليات المنفصلة لأداة tailboxbg بإعادة رسم الشاشة.

--beep-after

إصدار صوت تنبيه بعد أن يكمل المستخدم الأداة بالضغط على أحد الأزرار.

خيارات المساحات البيضاء¶

يمكن استخدام هذه الخيارات لتحويل المسافات البيضاء (مسافة، علامة جدولة، سطر جديد) أثناء قراءة dialog للبرنامج النصي:

الخيارات ليست مستقلة عن بعضها البعض:

• يتحقق Dialog مما إذا كان البرنامج النصي يحتوي على “\n” واحدة على الأقل (ما لم يُضبط الخيار --no-nl-expand) وسيتجاهل خياري --no-collapse و --trim.
• بعد التحقق من “\n” وخيار --no-nl-expand، يتعامل dialog مع خيار --trim.

إذا فُعّل خيار --trim، يتجاهل dialog خيار --no-collapse. حيث يُحول تسلسلات علامات الجدولة والمسافات (والأسطر الجديدة ما لم يُضبط -cr-wrap) إلى مسافة واحدة.

•

إذا لم تنطبق أي من حالتي “\n” أو --trim، يتحقق dialog من خيار --no-collapse ليقرر ما إذا كان سيقلص تسلسلات علامات الجدولة والمسافات إلى مسافة واحدة.

في هذه الحالة، يتجاهل dialog خيار --cr-wrap ولا يعدل الأسطر الجديدة.

بالأخذ بهذه التبعيات في الحسبان، إليك جدول يلخص السلوك لمختلف تركيبات الخيارات. يفترض الجدول أن البرنامج النصي يحتوي على “\n” واحدة على الأقل عندما لا يكون خيار --no-nl-expand مضبوطاً.

أسماء الودجات¶

تحتوي بعض الودجات (مثل formbox) على منطقة يمكن فيها تحرير الحقول. تُدار هذه الحقول في نافذة فرعية للودجة، وقد يكون لها ارتباطات مفاتيح منفصلة عن الودجة الرئيسة لأن النوافذ الفرعية مسجلة باسم مختلف.

بعض الودجات هي في الواقع ودجات أخرى، تستخدم إعدادات داخلية لتعديل السلوك. وتستخدم هذه الودجات نفس اسم الودجة الفعلية:

ارتباطات مدمجة¶

لا تسرد صفحة الدليل هذه ارتباطات المفاتيح لكل ويدجت (widget)، لأنه يمكن الحصول على هذه المعلومات التفصيلية عبر تشغيل dialog. إذا ضبطت خيار --trace، فسيكتب dialog معلومات ارتباط المفاتيح لكل ويدجت عند تسجيلها.

هناك بعض الارتباطات المدمجة، والمستقلة عن ويدجت بعينها:

مثال¶

يستخدم dialog عادةً مفاتيح مختلفة للتنقل بين الأزرار وجزء التحرير في الحوار مقابل التنقل داخل جزء التحرير نفسه. أي أن مفتاح tab (و back-tab) يتنقل بين الأزرار (أو بين الأزرار وجزء التحرير)، بينما تتنقل مفاتيح الأسهم بين الحقول داخل جزء التحرير. وتُعامل علامات الجدولة (Tabs) أيضاً كحالة خاصة للتنقل بين الويدجت، على سبيل المثال عند استخدام عدة ويدجت من نوع tailboxbg.

قد يرغب بعض المستخدمين في استخدام نفس المفتاح للتنقل داخل جزء التحرير وللتنقل بين الأزرار. ويدجت الاستمارة (form) مكتوبة لتدعم هذا النوع من إعادة تعريف المفاتيح، عبر إضافة مجموعة خاصة في dlgk_keys.h لـ “form” (يسار/يمين/التالي/السابق). إليك مثال على ارتباط يوضح كيفية القيام بذلك:

bindkey formfield TAB form_NEXT bindkey formbox TAB form_NEXT bindkey
formfield BTAB form_prev bindkey formbox BTAB form_prev

هذا النوع من إعادة التعريف لن يكون مفيداً في الويدجت الأخرى، مثل التقويم (calendar)، نظراً للعدد الكبير المحتمل من الحقول التي يجب التنقل بينها.

Original Dialog¶

أولاً، يجب مراعاة برنامج dialog “الأصلي” (الإصدارات 0.3 إلى 0.9). كان يحتوي على بعض الخيارات المكتوبة بشكل خاطئ (أو غير متسقة). يقوم برنامج dialog بربط تلك الخيارات المهجورة بالخيارات المفضلة. وهي تشمل:

Xdialog¶

هذا تطبيق لبيئة X، وليس برنامجاً طرفياً. مع بعض العناية، من الممكن كتابة سكربتات مفيدة تعمل مع كل من Xdialog و dialog.

يتجاهل برنامج dialog هذه الخيارات التي يتعرف عليها Xdialog:

يحتوي دليل Xdialog على قسم يناقش توافقيته مع dialog. توجد بعض الاختلافات التي لم تُعرض في الدليل. على سبيل المثال، تذكر توثيقات html ما يلي

لم يستخدم Dialog فاصلاً مختلفًا؛ ومن المرجح أن الاختلاف كان بسبب ارتباك يتعلق ببعض السكريبتات.

Whiptail¶

ثم هناك whiptail. لأغراض عملية، تديره دبيان (يُنجز القليل جدًا من العمل بواسطة مطوري المنبع). تدعي توثيقاته (README.whiptail) ما يلي

whiptail(1) هو بديل خفيف لبرنامج dialog(1)، لتوفير صناديق حوار لسكربتات
الصدفة. بُني على مكتبة النوافذ newt بدلاً من مكتبة ncurses، مما يسمح له بأن
يكون أصغر حجمًا في البيئات المضمنة مثل برامج التثبيت، وأقراص الإنقاذ، إلخ.
صُمم whiptail ليكون بديلًا متوافقًا مع dialog، ولكنه يحتوي على ميزات أقل: فبعض
صناديق الحوار غير مُنفذة، مثل tailbox وtimebox وcalendarbox، وغيرها.

بمقارنة الأحجام الفعلية (دبيان الاختبارية، 2007/1/10): إجمالي أحجام whiptail ومكتبات newt وpopt وslang هو 757 كيلوبايت. الرقم المقابل لبرنامج dialog (باحتساب ncurses) هو 520 كيلوبايت. تجاهل الفقرة الأولى.

الفقرة الثانية مضللة، لأن whiptail لا يعمل أيضًا مع الخيارات الشائعة لبرنامج dialog، مثل صندوق القياس (gauge). برنامج whiptail أقل توافقًا مع dialog من برنامج dialog 0.4 الأصلي الذي يعود لمنتصف التسعينيات.

يستعير دليل whiptail ميزات من dialog، على سبيل المثال، لكنه ومن الغريب يستشهد فقط بإصدارات dialog حتى 0.4 (1994) كمصدر. أي أن دليله يشير إلى ميزات استُعيرت من إصدارات أحدث من dialog، مثل،

• --gauge (منذ 0.5)
• --passwordbox (من تغييرات دبيان في 1999)،
• --default-item (من dialog 2000/02/22)،
• --output-fd (من dialog 2002/08/14).

تستخدم دبيان whiptail كبديل رسمي لبرنامج dialog.

يتجاهل برنامج dialog أو يسند هذه الخيارات التي يتعرف عليها whiptail:

توجد اختلافات مرئية لم تُعالج بواسطة خيارات سطر الأوامر:

• يضع dialog القوائم في منتصف النافذة. بينما يضع whiptail القوائم عادةً بمحاذاة الهامش الأيسر.
• يستخدم whiptail الأقواس الزاوية (“<” و “>”) لتمييز الأزرار. بينما يستخدم dialog الأقواس المربعة.
• يميز whiptail حدود العناوين الفرعية بأشرطة عمودية. بينما لا يميز dialog الحدود.
• يحاول whiptail تمييز الخلايا العلوية والسفلية لشريط التمرير بأسهم للأعلى وللأسفل. وعندما لا يتمكن من فعل ذلك، فإنه يملأ تلك الخلايا بلون خلفية شريط التمرير مما يربك المستخدم. بينما يستخدم dialog مساحة شريط التمرير بالكامل، وبذلك يحصل على دقة أفضل.