وحدة التحكم
وحدة التحكم هي النافذة الخاصة بالمحرك للتشخيص وتجربة الأشياء. تعرض ما يبلغ عنه المحرك (مشكلات في تكوينك، وبرامج نصية فشلت، ومكونات إضافية رجعت إلى الرسم المضمَّن)، وتعرض ما تطبعه برامجك النصية، وفيها محرر يمكنك فيه كتابة برنامج نصي وتشغيله على الفور.
فتح وحدة التحكم
اختر إظهار وحدة التحكم من قائمة منطقة الإعلام (أيقونة منطقة الإعلام)، أو شغّل الدالة المضمَّنة UIShowConsole من إجراء — مثلًا،
اربطها بمفتاح اختصار. لا شيء يفتح وحدة التحكم تلقائيًا ما لم تطلب ذلك بـ عند وصول رسالة (أدناه).
إذا كان تكوينك محميًا بكلمة مرور، تطلب وحدة التحكم كلمة المرور عند فتحها، ما لم تكن لا تزال متذكَّرة (الأمان). وما دامت وحدة
التحكم مفتوحة، لا تنتهي مدة كلمة المرور المتذكَّرة. وتنتظر UIShowConsole حتى تُفتح وحدة التحكم، بما في ذلك أثناء طلب كلمة المرور، وتعطي false
إذا لم تُفتح، مثلًا لأن مطالبة كلمة المرور أُلغيت.
تُغلق وحدة التحكم بزر الإغلاق فيها. ويحرر إغلاقها الذاكرة التي استخدمتها.
الأقسام الثلاثة
تبدّل الأزرار الموجودة في الأعلى ① بين ثلاثة أقسام، لكل منها شريط أدواته.
| القسم | ما يعرضه | شريط الأدوات |
|---|---|---|
| النظام | ما يبلغ عنه المحرك: ملاحظات عن تكوينك من آخر تحميل، والإجراءات والبرامج النصية التي فشلت وسبب فشلها، ومكوّن إضافي تعذّر عليه الرسم فتولى الرسم المضمَّن الأمر، وما شابه ذلك. | نسخ، مسح، عند وصول رسالة |
| المستخدم | كل ما تطبعه برامجك النصية بـ UtilityPrint، من كل إجراء. | نسخ، مسح، عند وصول رسالة |
| البرنامج النصي | محرر برامج نصية فوق جزء مخرجات. | تنفيذ، إيقاف الكل، إخفاء وحدة التحكم، تعليمات البرامج النصية، نسخ، لصق، مسح |
ينسخ نسخ النص المحدد، أو القسم كله عندما لا يكون هناك تحديد. ويفرغ مسح القسم.
ما دام القسم البرنامج النصي معروضًا، تظهر أسطر النظام والمستخدم الجديدة أيضًا في جزء مخرجاته، لكي تتمكن من مراقبة برنامج نصي قيد التشغيل دون تبديل الأقسام.
أثناء إغلاق وحدة التحكم
الأسطر التي تصل أثناء إغلاق وحدة التحكم لا تضيع: تُحفظ في ملفات مؤقتة وتُعرض في المرة التالية التي تفتح فيها وحدة التحكم. وعندما يُنهى Input.Observer، تُحذف، باستثناء ما يطبعه الحدث إيقاف تشغيل المحرك، الذي تعرضه وحدة التحكم في الجلسة التالية.
يختار عند وصول رسالة ① في شريطي أدوات النظام والمستخدم ما يفعله السطر الجديد أثناء إغلاق وحدة التحكم:
| الاختيار | ما يحدث |
|---|---|
| عدم فعل أي شيء | ينتظر السطر حتى تفتح وحدة التحكم. وهو الافتراضي. |
| إظهار UIShowMessageBox | يظهر السطر أيضًا في مربع رسالة. |
| فتح وحدة التحكم | تُفتح وحدة التحكم على ذلك القسم. |
عندما تكون وحدة التحكم مفتوحة، يُضاف السطر الجديد ببساطة؛ ولا يُظهر مربعًا أبدًا ولا يبدّل الأقسام. والاختيارات نفسها موجودة في صفحة وحدة التحكم بصفة رسائل النظام الجديدة ورسائل المستخدم الجديدة.
تشغيل برنامج نصي
- افتح القسم البرنامج النصي في وحدة التحكم.
- اكتب برنامجًا نصيًا أو الصقه في المحرر. وهو يستخدم لغة البرامج النصية الخاصة بـ Input.Observer (لغة البرامج النصية).
- اختر تنفيذ ② أو اضغط F5. وعند تحديد نص، لا يعمل إلا التحديد؛ وإلا فيعمل المحرر كله.
- يظهر الناتج وأي خطأ في جزء المخرجات أسفل المحرر. ويخفي إخفاء وحدة التحكم ذلك الجزء أو يُظهره.
- البرنامج النصي المشغَّل هنا يعمل مثل الإجراء: كل دالة مضمَّنة متاحة، ويعمل حتى ينتهي أو يُوقف. ويوقف إيقاف الكل كل برنامج نصي وإجراء قيد التشغيل، لا هذا وحده.
- هذا هو المكان الوحيد الذي تعمل فيه البرامج النصية في الوضع الآمن، لكي تتمكن من الفحص والإصلاح بينما لا يعمل أي شيء آخر (استكشاف الأخطاء وإصلاحها).
- يكمل المحرر أسماء الدوال المضمَّنة أثناء الكتابة؛ ويسرد Ctrl+Space كل شيء، وكتابة اسم مجال متبوعًا بنقطة تسرد الدوال المضمَّنة لذلك المجال. وبعد اختيار دالة مضمَّنة، يعرض تلميح معلماتها، مع تمييز المعلمة الحالية. وفي قائمة النقر بالزر الأيمن تحويل إلى تعليق وإلغاء التعليق للأسطر المحددة.
- يُحفظ نص المحرر بين الجلسات في
console.toml.
يفتح تعليمات البرامج النصية ③ مرجع لغة البرامج النصية في نافذة التعليمات (نافذة التعليمات)، باللغة التي يستخدمها Input.Observer (أو بالإنجليزية عندما لا توجد تعليمات بتلك اللغة).
صفحة وحدة التحكم
الوضع المتقدم. تُخفى صفحة وحدة التحكم في الوضع البسيط. وتبقى إعداداتها سارية.
تضم صفحة وحدة التحكم في نافذة التكوين إعدادات وحدة التحكم. وتسري عندما تختار تطبيق أو حفظ وإغلاق.
| الإعداد | ما يفعله | الافتراضي | النطاق |
|---|---|---|---|
| حد أسطر وحدة التحكم | بمجرد أن يحتوي قسم على هذا العدد من الأسطر، تُسقط الأقدم مع وصول أسطر جديدة. و0 يحتفظ بكل شيء. ويسري مع السطر التالي. | 5000 سطر | 0–1000000 |
| تحرير الذاكرة عند إغلاق وحدة التحكم | يعيد ذاكرة وحدة التحكم إلى Windows بمجرد إغلاقها. وقد يكون حدث الماوس أو لوحة المفاتيح التالي بعد ذلك أبطأ قليلًا جدًا. | مفعّل | مفعّل أو متوقف |
| رسائل النظام الجديدة | ما يفعله سطر النظام الجديد أثناء إغلاق وحدة التحكم: لا شيء أو مربع رسالة أو فتح وحدة التحكم (مثل عند وصول رسالة أعلاه) | لا شيء | — |
| رسائل المستخدم الجديدة | الشيء نفسه لأسطر المستخدم | لا شيء | — |
| خط نوافذ المحرك | الخط والحجم لتسميات وحدة التحكم وأزرارها ولمربعات الحوار الخاصة بالمحرك (كلمة المرور، والترخيص) | Segoe UI، 12 نقطة | 6–72 نقطة |
| خط محرر المحرك | الخط والحجم لأقسام وحدة التحكم ومحرر برامجها النصية | Consolas، 13 نقطة | 6–72 نقطة |
تحتفظ وحدة التحكم المفتوحة بخطوطها حتى تغلقها وتفتحها مرة أخرى.