المكونات الإضافية
المكوّن الإضافي برنامج منفصل يعمل مع Input.Observer. معظمها يرسم أشياء: المكوّن الإضافي Styles، الذي يأتي مع Input.Observer، يرسم أنماط الآثار المتحركة والتلميحات والرسائل المزيّنة. ويمكن لغيرها إضافة دوال تستدعيها البرامج النصية، أو تشغيل إجراءات مكتوبة بلغة أخرى. يبدأ Input.Observer كل مكوّن إضافي ويراقبه ويوقفه بنفسه؛ ولا تبدأ مكوّنًا إضافيًا يدويًا أبدًا.
تغطي هذه الصفحة إدارة المكونات الإضافية. أما كتابة مكوّن إضافي فموصوفة في وثائق مطوري المكونات الإضافية المنفصلة.
الوضع المتقدم. توجد صفحة المكونات الإضافية في القسم المحرك من التنقل، المخفي في الوضع البسيط. وتستمر المكونات الإضافية في العمل في الوضع البسيط، وتعرض صفحة المظهر أنماط أداة العرض وتتحكم فيها في أي من الوضعين.
تسري التغييرات في هذه الصفحة فورًا. وليست جزءًا من التغييرات غير المحفوظة في تكوينك: لا حاجة إلى تطبيق، ولا يتراجع عنها تجاهل. ولا تُصدَّر المكونات الإضافية ولا تُستورد أبدًا.
صفحة المكونات الإضافية
| الاسم | المسار | الإمكانات | الحالة | الإجراءات |
|---|---|---|---|---|
| Input.Observer.Styles | C:\Program Files\Input.Observer\Input.Observer.Styles.exe | الأنماط | سليم | تعطيل |
| مكوّن إضافي نموذجي | D:\Tools\SamplePlugin.exe | دوال البرامج النصية | غير مستخدم | الاستخدام كأداة العرض |
تسرد الصفحة كل مكوّن إضافي مسجَّل ②، مع مربع بحث وعامل تصفية للحالة (كل الحالات وسليم ويحتاج إلى انتباه ومعطّل) فوق القائمة. ويعدّ سطر العنوان المكونات الإضافية المسجَّلة والسليمة.
| العمود | ما يعرضه |
|---|---|
| الاسم | اسم المكوّن الإضافي. ولصف أداة العرض شارة أداة العرض. وينسخ زر النسخ الاسم تمامًا، وهو ما يحتاج إليه استدعاء PluginSendMessage في برنامج نصي. |
| المسار | ملف برنامج المكوّن الإضافي. ويفتح الزر في نهايته مستكشف الملفات مع تحديد الملف. |
| الإمكانات | ما يقدمه المكوّن الإضافي: أثر الإيماءة، والتلميح، وعرض الرسائل، والأنماط، وأوامر البرامج النصية، ودوال البرامج النصية، ومحرك البرامج النصية، والإعدادات، والإعدادات هنا. والمكوّن الإضافي الذي لا يعمل يعرض ما قدمه آخر مرة عمل فيها. |
| الحالة | راجع الجدول أدناه. |
| الإجراءات | الأزرار التي تنطبق على هذا المكوّن الإضافي الآن (أدناه). |
| الحالة | المعنى |
|---|---|
| سليم | يعمل ويستجيب. |
| جارٍ البدء… | قيد البدء. وتفحص الصفحة مرة أخرى كل ثانية حتى يستقر. |
| غير مستخدم | مكوّن إضافي للرسم ليس أداة العرض، أو أداة العرض بينما لا يوجد شيء مضبوط عليها. لا يعمل، ولا يستخدم أي ذاكرة ("غير مستخدم" أدناه). |
| لا يستجيب | يعمل لكنه لم يستجب منذ 10 ثوانٍ. ويعيد Input.Observer تشغيله. |
| معطّل | أُوقف بـ تعطيل. |
| معطّل تلقائيًا -- فشل البدء | فشل في البدء عدة مرات متتالية. وتوقف Input.Observer عن المحاولة ("عندما يفشل مكوّن إضافي" أدناه). |
| أغلقه المكوّن الإضافي | أغلق المكوّن الإضافي نفسه عمدًا. ويبقى مغلقًا حتى تختار إعادة المحاولة، أو تعطّله وتمكّنه، أو تعيد تشغيل Input.Observer. |
الأزرار في الإجراءات:
| الزر | يظهر عندما | ما يفعله |
|---|---|---|
| الاستخدام كأداة العرض | مكوّن إضافي للرسم مفعّل وليس أداة العرض | يجعله أداة العرض (أدناه). |
| الإعدادات (الترس) | للمكوّن الإضافي إعدادات وهو يعمل أو غير مستخدم | يفتح إعداداته (أدناه). |
| معاينة / إيقاف المعاينة | يرسم المكوّن الإضافي أثرًا أو تلميحًا أو رسائل | يعرض ما يرسمه (أدناه). |
| إعادة المحاولة | معطّل تلقائيًا، أو أغلقه المكوّن الإضافي | يبدؤه مرة أخرى ويمسح عدد مرات الفشل. |
| السماح بالاستدعاءات الراجعة / حظر الاستدعاءات الراجعة | يوفر المكوّن الإضافي دوال برامج نصية أو محرك برامج نصية | راجع "الاستدعاءات الراجعة" أدناه. |
| تمكين / تعطيل | دائمًا | يبدأ المكوّن الإضافي أو يوقفه مع إبقائه مسجَّلًا. |
| إزالة | دائمًا | يوقف المكوّن الإضافي وينساه. ولا يُحذف البرنامج نفسه. |
يسأل تعطيل وإزالة أولًا عندما تحتاج برامج نصية في تكوينك إلى المكوّن الإضافي — برامج نصية تعمل في محرك برامجه النصية أو تستدعي دواله — ويسردانها. وتتوقف تلك البرامج النصية عن العمل ما دام المكوّن الإضافي غائبًا.
إضافة مكوّن إضافي
- اختر إضافة مكوّن إضافي… ① واختر برنامج المكوّن الإضافي (
.exe). - يبدأ Input.Observer البرنامج مرة واحدة ليسأله عن اسمه، ثم يبدؤه مرة أخرى ويتحقق من أنه يتصل ويستجيب. ويستغرق ذلك بضع ثوانٍ.
- إذا اجتاز الفحص، يُضاف المكوّن الإضافي في أعلى القائمة ويستمر في العمل. وإذا كان يرسم آثارًا أو تلميحات أو رسائل، يصبح أيضًا أداة العرض، وتذكر ملاحظة "تم تغيير أداة العرض" ذلك.
إذا لم يجتز المكوّن الإضافي الفحص، تشرح "تعذّرت إضافة المكوّن الإضافي" السبب: الملف غير موجود، أو لم يستجب البرنامج أو استجاب بشكل خاطئ (قد لا يكون مكوّنًا إضافيًا لـ Input.Observer)، أو استغرق وقتًا طويلًا، أو اسمه مستخدم بالفعل من مكوّن إضافي مسجَّل آخر، أو تستخدم دوال برامجه النصية أو محرك برامجه النصية أسماء يستخدمها مكوّن إضافي آخر بالفعل. وفي كل حالة لا يُضاف شيء.
يحتفظ Input.Observer بمسار المكوّن الإضافي نسبةً إلى مجلده الخاص عندما يكون المكوّن الإضافي داخله، لذا يستمر المكوّن الإضافي المثبت بجانب Input.Observer في العمل إذا نُقل Input.Observer.
الثقة بمكوّن إضافي
- إضافة مكوّن إضافي تشغّله. تبدأ الخطوة 2 البرنامج فورًا، بأذوناتك، ومن ذلك الحين يبدؤه Input.Observer في كل مرة يبدأ فيها. ولا يتحقق Input.Observer ممن صنع المكوّن الإضافي أو ما إذا كان موقَّعًا. أضف فقط برامج من مصادر تثق بها، كما تفعل قبل تشغيل أي برنامج.
- يعمل المكوّن الإضافي كبرنامج مستقل. ولا يعمل أبدًا داخل Input.Observer، ولا ينتظر Input.Observer أبدًا مكوّنًا إضافيًا أثناء معالجة الماوس ولوحة المفاتيح، لذا لا يمكن لمكوّن إضافي بطيء أو معطوب أن يجعل إدخالك يتأخر.
- يحصل المكوّن الإضافي الذي يرسم على ضربات إيماءاتك ونص التلميحات والرسائل، لكي يتمكن من رسمها.
- يحصل المكوّن الإضافي الذي له دوال برامج نصية على القيم التي تمررها البرامج النصية إلى تلك الدوال.
أداة العرض
أداة العرض هي المكوّن الإضافي الوحيد الذي يرسم لـ Input.Observer: أنماط الآثار، والتلميحات والرسائل عندما تكون مضبوطة على مطابقة النمط في صفحة المظهر. ولا يكون إلا مكوّن إضافي واحد أداة العرض في كل مرة. ويسجّل التثبيت القياسي المكوّن الإضافي Styles كأداة عرض.
لجعل مكوّن إضافي آخر للرسم أداة العرض، اختر الاستخدام كأداة العرض في صفه. يبدّل المحرك فورًا: تبدأ أداة العرض الجديدة، وتتوقف السابقة وتعرض غير مستخدم، ويُضبط عليها الأثر والتلميحات والرسائل التي يستطيع المكوّن الإضافي الجديد رسمها. وتحدد اختياراتك في صفحة المظهر بعد ذلك ما يرسمه (المظهر). والمكوّن الإضافي الذي لا يقدم أنماطًا يظهر كبطاقة واحدة في المعرض، باسمه؛ وتحدد إعداداته الخاصة كيف يرسم.
يؤدي تعطيل أداة العرض أو إزالتها إلى عدم وجود أداة عرض: يرسم الأثر الكلاسيكي ونافذة التلميح ونافذة الرسائل الخاصة بـ Input.Observer حتى تختار أداة أخرى.
غير مستخدم
لا يشغّل Input.Observer مكوّنًا إضافيًا ليس لديه ما يفعله. لا يعمل المكوّن الإضافي للرسم إلا ما دام أداة العرض وهناك شيء في صفحة المظهر مضبوط عليه. أما المكوّن الإضافي الذي يوفر دوال برامج نصية أو محرك برامج نصية فيعمل دائمًا ما دام ممكَّنًا.
المكوّن الإضافي غير المستخدم يُبدأ للحظة عندما تفتح إعداداته أو تعاينه، ويعود إلى غير مستخدم بعد ذلك. ويتوقف المكوّن الإضافي Styles بعد
نحو دقيقة من آخر تغيير أجريته في إعداداته. ويفشل استدعاء PluginSendMessage في برنامج نصي لمكوّن إضافي للرسم لا يعمل بخطأ يذكر ذلك؛ ولا
يبدأ المكوّن الإضافي.
إعدادات المكوّن الإضافي
يفتح الترس في صف مكوّن إضافي إعداداته:
- المكوّن الإضافي المعلَّم بـ الإعدادات هنا يعرض إعداداته في نافذة ترسمها نافذة التكوين، مع قائمة أقسام على اليسار. وإعدادات المكوّن الإضافي Styles موصوفة في آثار الإيماءات.
- أي مكوّن إضافي آخر له الإعدادات يفتح نافذة إعداداته الخاصة.
المكوّن الإضافي الذي لا يعمل يُبدأ أولًا، لذا قد تستغرق النافذة بضع ثوانٍ لتمتلئ. تسري التغييرات فورًا ويحفظها المكوّن الإضافي نفسه، في ملفه الخاص بجانب ملف التكوين؛ فلا تنتظر تطبيق، ولا يتراجع عنها تجاهل. ويعيد استعادة الإعدادات الافتراضية القسم المحدد إلى القيم الافتراضية للمكوّن الإضافي. وإذا تعذّر إجراء تغيير، تذكر ملاحظة في النافذة السبب: لم يبدأ المكوّن الإضافي أو لا يقدم هذه الإعدادات، أو لم يستجب في الوقت المحدد، أو رفض التغيير، أو أجراه لكنه لم يتمكن من حفظه.
المعاينة
تعرض معاينة ما سيرسمه مكوّن إضافي للرسم، دون إيماءة حقيقية: أثرًا يتبع مؤشرك، وتلميحًا نموذجيًا، ورسالة نموذجية. انقر بزر الماوس الأيمن لرؤية الأثر ينتهي ويبدأ من جديد؛ ولا تفتح النقرة بالزر الأيمن شيئًا أثناء المعاينة.
أثناء تشغيل المعاينة، تتوقف الإيماءات مؤقتًا في كل مكان، ويذكر شريط في الصفحة ذلك. وتنتهي المعاينة عندما تضغط Esc، أو تختار إيقاف المعاينة، أو تغادر صفحة المكونات الإضافية، أو يتوقف المكوّن الإضافي. ولا يمكن بدء معاينة أثناء تسجيل ماكرو أو تدريب الإيماءات.
عندما يفشل مكوّن إضافي
يفحص Input.Observer كل مكوّن إضافي قيد التشغيل كل 5 ثوانٍ.
- المكوّن الإضافي الذي يتوقف عن الاستجابة لمدة 10 ثوانٍ (فحصان فائتان) يعرض لا يستجيب ويُعاد تشغيله.
- المكوّن الإضافي الذي يُنهى بشكل غير متوقع يُعاد تشغيله بعد 10 ثوانٍ.
- المكوّن الإضافي الذي يفشل في البدء يُحاوَل مرة أخرى بعد 2 و5 و10 ثوانٍ. وبعد المحاولة الفاشلة الثالثة يصبح معطّل تلقائيًا -- فشل البدء ويتركه Input.Observer وشأنه، حتى عبر إعادات التشغيل، حتى تختار إعادة المحاولة. ويعود عدد مرات الفشل إلى الصفر بمجرد أن يعمل المكوّن الإضافي دون مشكلات لمدة 5 دقائق.
- المكوّن الإضافي الذي يغلق نفسه عمدًا يعرض أغلقه المكوّن الإضافي ولا يُعاد تشغيله حتى تختار إعادة المحاولة، أو تعطّله وتمكّنه، أو تعيد تشغيل Input.Observer.
ما دامت أداة العرض متوقفة، يرسم الأثر الكلاسيكي ونافذة التلميح ونافذة الرسائل الخاصة بـ Input.Observer مكانها، وتذكر صفحة المظهر ذلك مع زر إعادة التشغيل. وفي كل مرة يحدث ذلك، يُكتب سطر في القسم النظام في وحدة التحكم (وحدة التحكم).
عندما يبدأ Input.Observer، يبدأ كل مكوّن إضافي لديه عمل ينتظر كلًا منها حتى نحو 5 ثوانٍ؛ وتسمّي شاشة البدء المكوّن الإضافي الذي تحمّله. والمكوّن الإضافي الذي يفوت ذلك الوقت يُلتقط بعد قليل. وعندما يُنهى Input.Observer، يغلق كل مكوّن إضافي، ولا يمكن لمكوّن إضافي أبدًا أن يستمر في العمل بعد توقف Input.Observer. وفي الوضع الآمن لا يُبدأ أي مكوّن إضافي (استكشاف الأخطاء وإصلاحها).
الاستدعاءات الراجعة
يمكن للمكوّن الإضافي الذي يوفر دوال برامج نصية أو محرك برامج نصية أن يطلب تشغيل برنامج نصي لـ Input.Observer أثناء معالجة استدعاء. ويُحظر ذلك ما لم تختر السماح بالاستدعاءات الراجعة في صفه وتؤكد. اسمح بذلك فقط لمكوّن إضافي تثق به: فطلباته يمكنها حينئذٍ فعل أي شيء يستطيعه برنامج نصي هنا — ضغط المفاتيح، ونقل النوافذ وإغلاقها، وتشغيل البرامج — بما في ذلك في النوافذ التي تعمل كمسؤول، التي لا يستطيع المكوّن الإضافي الوصول إليها بمفرده. ويسحب حظر الاستدعاءات الراجعة الإذن مرة أخرى.