الخطوات والبرنامج النصي وAutoHotkey
يمكن كتابة ما يفعله الإجراء بثلاث طرق. يختار مكتوب بصيغة، في البطاقة ما يفعله في صفحة الإجراءات، الطريقة التي تعمل.
| الصيغة | ما هي | اخترها عندما |
|---|---|---|
| خطوات | قائمة من الخطوات تختارها وتملؤها، صف لكل خطوة. لا تعليمات برمجية لكتابتها. | تريد بناء الإجراء دون كتابة تعليمات برمجية. تناسب معظم الإجراءات: إرسال مفاتيح، أو كتابة نص، أو نقل نوافذ أو إغلاقها، أو الانتظار، أو طرح سؤال. |
| برنامج نصي | لغة البرامج النصية الخاصة بـ Input.Observer، تُكتب في محرر تعليمات برمجية. | تحتاج إلى عمليات حسابية، أو بناء نص من أجزاء، أو حلقات تعدّ بمتغير، أو أي شيء لا تستطيع الخطوات التعبير عنه. |
| AutoHotkey | برنامج نصي لـ AutoHotkey v2، يشغّله AutoHotkey نفسه. | لديك بالفعل تعليمات برمجية لـ AutoHotkey، أو تحتاج إلى شيء لا يفعله إلا AutoHotkey. |
تعمل الخطوات والبرنامج النصي داخل Input.Observer وتستدعيان الدوال المضمَّنة نفسها: الخطوات طريقة مرئية لكتابة ما سيكتبه البرنامج النصي. راجع الخطوات ومرجع لغة البرامج النصية.
تحتفظ كل صيغة بمحتواها الخاص
يحتفظ الإجراء بمتن للخطوات ومتن للبرنامج النصي ومتن لـ AutoHotkey جنبًا إلى جنب. يغيّر تبديل مكتوب بصيغة ① المتن الذي يعمل. ولا يحذف المتون الأخرى أبدًا، لذا يمكنك التبديل مرة أخرى.
إذا كانت الصيغة التي تحددها فارغة بينما في صيغة أخرى محتوى، يذكر إشعار أسفل المبدِّل أن تشغيل الإجراء لا يفعل شيئًا، ويعرض زرًا لاستخدام الصيغة التي فيها محتوى.
التبديل من الخطوات إلى البرنامج النصي
عندما تبدّل من خطوات إلى برنامج نصي وفي الإجراء خطوات ومتن البرنامج النصي فارغ، يعرض Input.Observer ترجمة الخطوات: هل تريد تحويل الخطوات إلى برنامج نصي؟ اختر تحويل لوضع الترجمة في محرر البرامج النصية.
- تبقى الخطوات كما هي. ويعرضها التبديل مرة أخرى إلى خطوات دون تغيير.
- لا يتحول شيء في الاتجاه المعاكس. لا يمكن تحويل برنامج نصي إلى خطوات.
- الخطوات التي تستخدم التكرار ما دام… أو التكرار حتى… أو الخروج من الحلقة أو إيقاف الخطوات لا تُعرض ترجمتها، لأنه ليس في البرنامج النصي عبارات مقابلة. ولا يزال بإمكانك التبديل؛ لكن متن البرنامج النصي يبدأ فارغًا.
- لا يُحوَّل أبدًا إلى AutoHotkey أو منه.
- عندما تكون الخطوات تسجيلًا من صفحة المسجِّل، يذكر مربع الحوار أيضًا أن البرنامج النصي يتجاهل سرعة إعادة التشغيل وتفاصيل مسار الماوس عند إعادة التشغيل: تعمل فترات انتظاره بالسرعة المسجَّلة وتُعاد كل حركة ماوس مسجَّلة (إعدادات المسجِّل).
تعرض من الخطوات إلى البرنامج النصي ما يصبح عليه كل نوع من الخطوات.
AutoHotkey
AutoHotkey برنامج منفصل يبدؤه Input.Observer عندما يعمل إجراء AutoHotkey. وهو غير مضمَّن؛ تثبّت AutoHotkey v2 بنفسك وتخبر Input.Observer بمكانه.
- ثبّت AutoHotkey v2.
- في صفحة عام، فعّل تمكين AutoHotkey واضبط الملف التنفيذي لـ AutoHotkey على ملف برنامجه، مثل
AutoHotkey64.exe. - يظهر الآن AutoHotkey تحت مكتوب بصيغة. طبّق تغييراتك لكي يستخدم المحرك الإعداد الجديد.
القواعد:
- لا يُعرض AutoHotkey تحت مكتوب بصيغة إلا ما دام تمكين AutoHotkey مفعّلًا، أو عندما يعمل الإجراء بالفعل كـ AutoHotkey. وإجراء AutoHotkey مع إيقاف AutoHotkey لا يفعل شيئًا، وتذكر الصفحة ذلك.
- استخدم إصدارًا عاديًا من AutoHotkey. الإصدارات التي في اسمها
_UIA، مثلAutoHotkey64_UIA.exe، لا يمكنها تشغيل البرامج النصية من Input.Observer. - عندما يكون AutoHotkey مفعّلًا لكن يتعذّر العثور على برنامجه عند البدء أو عند إعادة تحميل التكوين، يطلب منك Input.Observer استعراض الملف التنفيذي لـ AutoHotkey أو ترك الوضع كما هو.
- يبدأ كل تشغيل عملية AutoHotkey جديدة ببرنامجك النصي. ولا يمكنها استدعاء الدوال المضمَّنة في Input.Observer. ومع تشغيل الانتظار حتى ينتهي، يعمل الإجراء حتى ينتهي البرنامج النصي من تلقاء نفسه، وينهيه مفتاح اختصار إيقاف كل الإجراءات (البرامج النصية التي تظل قيد التشغيل).
- قبل برنامجك النصي، يضبط Input.Observer متغيرات تصف المشغِّل، مثل
IO_ActionNameوIO_TriggerKindونافذة الإيماءة أو مفتاح الاختصار (متغيرات AutoHotkey). وتعرض قائمة المتغيرات المتاحة هنا في المحرر المتغيرات التي توفرها مشغِّلات الإجراء؛ انقر على أحدها لإدراجه. - ما يكتبه البرنامج النصي في مخرجاته القياسية يظهر في وحدة التحكم التشخيصية، بادئًا بـ
AHK:(وحدة التحكم التشخيصية).
يمكن لإجراء خطوات أو برنامج نصي أيضًا تشغيل جزء من تعليمات AutoHotkey البرمجية بالدالة المضمَّنة AutoHotkeyExecuteScript،
التي تنتظر حتى ينتهي، أو بدء تشغيله بـ AutoHotkeyStartScript، التي لا تنتظر. وينطبق الإعداد نفسه والملف التنفيذي نفسه.
البرامج النصية التي تظل قيد التشغيل
يظل البرنامج النصي لـ AutoHotkey الذي يحتوي على مفاتيح اختصار أو نصوص اختصار (hotstrings) أو مؤقت قيد التشغيل بعد سطره الأخير. لبدء تشغيل برنامج كهذا من Input.Observer، أوقف الانتظار حتى ينتهي أسفل محرر AutoHotkey. ويوجد هذا المفتاح أينما وُجد نص AutoHotkey: في الإجراءات، والبرامج النصية «قبل» و«بعد»، والأحداث العامة، والمقتطفات.
| الانتظار حتى ينتهي مشغَّل | الانتظار حتى ينتهي متوقف | |
|---|---|---|
| الإجراء | يعمل حتى ينتهي البرنامج النصي | ينتهي بمجرد بدء AutoHotkey |
| ما يكتبه البرنامج النصي | يظهر في وحدة التحكم التشخيصية، بادئًا بـ AHK: | لا يُعرض |
| خطأ في بناء الجملة | يظهر في وحدة التحكم التشخيصية | يعرض AutoHotkey مربع الخطأ الخاص به |
| مفتاح اختصار إيقاف كل الإجراءات | ينهي البرنامج النصي | يتركه قيد التشغيل |
| حفظ الإعدادات أو إعادة تحميل التكوين | ينهي البرنامج النصي، مع الإجراءات الأخرى قيد التشغيل | يتركه قيد التشغيل، ما لم يكن حدث تحميل التكوين هو الذي بدأه |
| إنهاء Input.Observer | ينهي البرنامج النصي | ينهي البرنامج النصي |
البرنامج النصي الذي بدأه تحميل التكوين ينتهي عند حفظ الإعدادات أو إعادة تحميلها، لأن ذلك الحدث يعمل عندئذٍ مرة أخرى ويبدأ نسخة جديدة. ولولا ذلك، لترك كل حفظ نسخة إضافية قيد التشغيل. وللإبقاء على نسخة واحدة من برنامج نصي قيد التشغيل طوال الجلسة، ضعه في تحميل التكوين مع إيقاف الانتظار حتى ينتهي.
تعمل AutoHotkeyStartScript بالطريقة نفسها التي يعمل بها المفتاح وهو متوقف، وتُرجع معرّف عملية AutoHotkey التي بدأتها.
متغيرات AutoHotkey
يبدأ كل تشغيل لـ AutoHotkey ببضعة أسطر يضيفها Input.Observer قبل برنامجك النصي، تضبط متغيرات IO_ مما شغّل الإجراء. وينطبق
هذا على الإجراء المكتوب كـ AutoHotkey وعلى التعليمات البرمجية المشغَّلة بـ AutoHotkeyExecuteScript أو AutoHotkeyStartScript،
التي تحصل على متغيرات الإجراء الذي استدعاها.
كل تشغيل يضبط هذه الثلاثة:
| المتغير | يحمل |
|---|---|
IO_ActionName | اسم الإجراء. بالنسبة إلى حدث عام، Global_Event_ متبوعًا باسم الحدث في ملف التكوين، مثل Global_Event_release أو Global_Event_foreground_changed. ويكون فارغًا عندما لا يشغّل شيء التشغيل، مثل برنامج نصي يُشغَّل من وحدة التحكم. |
IO_AppGroupName | اسم مجموعة التطبيقات التي وُجد فيها الإجراء، مثل Global. ويكون فارغًا للحدث العام. |
IO_TriggerKind | ما شغّل التشغيل: Gesture أو Hotkey أو TextExpansion أو MouseButton (مشغِّل ضغطة زرين، أو حدث عام لزر ماوس أو تحرير زر الرسم) أو Wheel (مشغِّل عجلة أو حدث عام للعجلة) أو None. |
البقية تعتمد على المشغِّل، ولا تُضبط إلا متغيرات ذلك المشغِّل:
| المشغِّل | المتغير | يحمل |
|---|---|---|
| الإيماءة | IO_GestureWindow | النافذة التي بدأت الإيماءة فوقها |
IO_GestureButton | زر الرسم: left أو right أو middle أو x1 أو x2، أو key لمفتاح الرسم | |
IO_GestureStartX، IO_GestureStartY | مكان بدء الضربة | |
IO_GestureEndX، IO_GestureEndY | مكان انتهائها | |
IO_GestureBoundsLeft، IO_GestureBoundsTop، IO_GestureBoundsRight، IO_GestureBoundsBottom | المستطيل المحيط بالضربة كلها | |
IO_GesturePoints | كل نقطة في الضربة بترتيب الرسم، كمصفوفة من مصفوفات [x, y] | |
| مفتاح الاختصار | IO_HotkeyWindow | النافذة الموجودة في المقدمة عند ضغط مفتاح الاختصار |
IO_HotkeyVkCode | رمز المفتاح الظاهري في Windows للمفتاح الأخير، مثل 75 لـ K | |
IO_HotkeyModifiers | مفاتيح التعديل في المجموعة، مجموعةً معًا: Ctrl 1، Shift 2، Alt 4، Win 8 (Ctrl+Alt هو 5) | |
| توسيع النص | IO_TextExpansionWindow | النافذة التي كتبت فيها |
IO_TextExpansionPattern | الاختصار الذي كتبته | |
| حدث زر الماوس | IO_MouseWindow | النافذة الواقعة تحت المؤشر |
IO_MouseButton | الزر: left أو right أو middle أو x1 أو x2؛ ولـ تحرير زر الرسم بعد إيماءة مرسومة بمفتاح الرسم، key | |
IO_MouseX، IO_MouseY | مكان المؤشر | |
| مشغِّل العجلة أو حدث العجلة | IO_WheelWindow | لمشغِّل العجلة، النافذة التي ضغطت زر الرسم فوقها؛ ولحدث العجلة، النافذة الواقعة تحت المؤشر |
IO_WheelDelta | مقدار دوران العجلة، كما يبلغ عنه Windows: 120 لدرجة واحدة من عجلة عادية (ترسل العجلات ذات التمرير السلس ولوحات اللمس خطوات أصغر)، موجب بعيدًا عنك (أو إلى اليمين)، وسالب نحوك (أو إلى اليسار). ويتلقى مشغِّل العجلة دائمًا 120 أو -120 | |
IO_WheelHorizontal | true للف العجلة جانبيًا، وfalse للف العادي | |
IO_WheelX، IO_WheelY | مكان المؤشر | |
IO_WheelButton | لمشغِّل العجلة، زر الرسم الذي ضغطته مع الاستمرار: left أو right أو middle أو x1 أو x2، أو key لمفتاح الرسم. ويكون فارغًا لحدث العجلة |
- النوافذ مقابض نوافذ، أرقام يقرؤها AutoHotkey كمعرّف نافذة:
"ahk_id " IO_GestureWindowيسمّي النافذة فيWinActivateوWinGetTitleودوال النوافذ الأخرى. - المواضع إحداثيات شاشة بالبكسل الفعلي، من الزاوية العلوية اليسرى للشاشة الرئيسية. اضبط
CoordMode "Mouse", "Screen"قبل استخدامها مع دوال الماوس في AutoHotkey، التي تعمل في غير ذلك بالنسبة إلى النافذة النشطة. - النص يصل تمامًا كما كان؛ وتُهرَّب نيابةً عنك علامات الاقتباس والعلامات المائلة العكسية وفواصل الأسطر في اسم إجراء أو مجموعة.
- المتغير الذي لا يوفره المشغِّل لا يُضبط على الإطلاق، ويوقف AutoHotkey البرنامج النصي عندما يقرأ متغيرًا غير مضبوط.
والإجراء الذي له عدة أنواع من المشغِّلات، أو المقتطف المستدعى من إجراءات مختلفة، يجب أن يفحص
IO_TriggerKindأولًا، أو يستخدمIsSet(IO_GestureWindow).
مثلًا، إجراء يعمل من إيماءة أو مفتاح اختصار، يحضر النافذة التي استُخدم عليها إلى المقدمة ويعرض عنوانها:
CoordMode "Mouse", "Screen"
win := IO_TriggerKind = "Gesture" ? IO_GestureWindow : IO_HotkeyWindow
WinActivate "ahk_id " win
MsgBox WinGetTitle("ahk_id " win), IO_ActionName
محركات البرامج النصية من المكونات الإضافية
يمكن لمكوّن إضافي أن يضيف محرك برامج نصية خاصًا به. عندئذٍ يظهر تحت مكتوب بصيغة باسم المكوّن الإضافي، ويذهب النص الذي تكتبه هناك إلى المكوّن الإضافي تمامًا كما كُتب؛ ولا يفحصه Input.Observer. راجع المكونات الإضافية.
- لا يوفّر أي مكوّن إضافي مسجَّل المحرك، مثلًا لأن المكوّن الإضافي أُزيل: يُظهر مكتوب بصيغة المحرك على أنه غير مسجَّل، ويذكر تحذير أسفله أن البرنامج النصي يُتخطى عند تشغيله. وعندئذٍ لا يفعل الإجراء شيئًا، ولا تظهر أي رسالة بذلك.
- المكوّن الإضافي مسجَّل لكنه لا يستطيع تولّي التشغيل، مثلًا لأنه معطَّل أو متوقف أو قيد إعادة التشغيل: لا يُشغَّل الإجراء ولا تُعاد محاولته لاحقًا. ويُكتب سطر في القسم النظام في وحدة التحكم يذكر المكوّن الإضافي والمحرك (وحدة التحكم)، ويذكر إعلام من Windows الإجراء والمكوّن الإضافي. ولا يظهر الإعلام إلا عندما يكون إعلامات Windows قيد التشغيل (الإعدادات العامة).
في الوضع البسيط
لا يعرض الوضع البسيط مكتوب بصيغة إلا لإجراء له بالفعل برنامج نصي أو متن AutoHotkey. ولأي إجراء آخر تعرض البطاقة الخطوات مباشرةً. لكتابة إجراء جديد كبرنامج نصي، حوّل النافذة إلى الوضع المتقدم (نافذة التكوين).