إنتقل إلى المحتوى الرئيسي

الخطوات والبرنامج النصي وAutoHotkey

يمكن كتابة ما يفعله الإجراء بثلاث طرق. يختار مكتوب بصيغة، في البطاقة ما يفعله في صفحة الإجراءات، الطريقة التي تعمل.

ما يفعله
مكتوب بصيغة
خطواتبرنامج نصيAutoHotkey
يحتفظ كل وضع بمحتواه الخاص. يتم تشغيل الوضع المحدد فقط.
الصيغةما هياخترها عندما
خطواتقائمة من الخطوات تختارها وتملؤها، صف لكل خطوة. لا تعليمات برمجية لكتابتها.تريد بناء الإجراء دون كتابة تعليمات برمجية. تناسب معظم الإجراءات: إرسال مفاتيح، أو كتابة نص، أو نقل نوافذ أو إغلاقها، أو الانتظار، أو طرح سؤال.
برنامج نصيلغة البرامج النصية الخاصة بـ Input.Observer، تُكتب في محرر تعليمات برمجية.تحتاج إلى عمليات حسابية، أو بناء نص من أجزاء، أو حلقات تعدّ بمتغير، أو أي شيء لا تستطيع الخطوات التعبير عنه.
AutoHotkeyبرنامج نصي لـ AutoHotkey v2، يشغّله AutoHotkey نفسه.لديك بالفعل تعليمات برمجية لـ AutoHotkey، أو تحتاج إلى شيء لا يفعله إلا AutoHotkey.

تعمل الخطوات والبرنامج النصي داخل Input.Observer وتستدعيان الدوال المضمَّنة نفسها: الخطوات طريقة مرئية لكتابة ما سيكتبه البرنامج النصي. راجع الخطوات ومرجع لغة البرامج النصية.

تحتفظ كل صيغة بمحتواها الخاص​

يحتفظ الإجراء بمتن للخطوات ومتن للبرنامج النصي ومتن لـ AutoHotkey جنبًا إلى جنب. يغيّر تبديل مكتوب بصيغة ① المتن الذي يعمل. ولا يحذف المتون الأخرى أبدًا، لذا يمكنك التبديل مرة أخرى.

إذا كانت الصيغة التي تحددها فارغة بينما في صيغة أخرى محتوى، يذكر إشعار أسفل المبدِّل أن تشغيل الإجراء لا يفعل شيئًا، ويعرض زرًا لاستخدام الصيغة التي فيها محتوى.

التبديل من الخطوات إلى البرنامج النصي​

عندما تبدّل من خطوات إلى برنامج نصي وفي الإجراء خطوات ومتن البرنامج النصي فارغ، يعرض Input.Observer ترجمة الخطوات: هل تريد تحويل الخطوات إلى برنامج نصي؟ اختر تحويل لوضع الترجمة في محرر البرامج النصية.

  • تبقى الخطوات كما هي. ويعرضها التبديل مرة أخرى إلى خطوات دون تغيير.
  • لا يتحول شيء في الاتجاه المعاكس. لا يمكن تحويل برنامج نصي إلى خطوات.
  • الخطوات التي تستخدم التكرار ما دام… أو التكرار حتى… أو الخروج من الحلقة أو إيقاف الخطوات لا تُعرض ترجمتها، لأنه ليس في البرنامج النصي عبارات مقابلة. ولا يزال بإمكانك التبديل؛ لكن متن البرنامج النصي يبدأ فارغًا.
  • لا يُحوَّل أبدًا إلى AutoHotkey أو منه.
  • عندما تكون الخطوات تسجيلًا من صفحة المسجِّل، يذكر مربع الحوار أيضًا أن البرنامج النصي يتجاهل سرعة إعادة التشغيل وتفاصيل مسار الماوس عند إعادة التشغيل: تعمل فترات انتظاره بالسرعة المسجَّلة وتُعاد كل حركة ماوس مسجَّلة (إعدادات المسجِّل).

تعرض من الخطوات إلى البرنامج النصي ما يصبح عليه كل نوع من الخطوات.

AutoHotkey​

AutoHotkey برنامج منفصل يبدؤه Input.Observer عندما يعمل إجراء AutoHotkey. وهو غير مضمَّن؛ تثبّت AutoHotkey v2 بنفسك وتخبر Input.Observer بمكانه.

  1. ثبّت AutoHotkey v2.
  2. في صفحة عام، فعّل تمكين AutoHotkey واضبط الملف التنفيذي لـ AutoHotkey على ملف برنامجه، مثل AutoHotkey64.exe.
  3. يظهر الآن 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_WheelHorizontaltrue للف العجلة جانبيًا، و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. ولأي إجراء آخر تعرض البطاقة الخطوات مباشرةً. لكتابة إجراء جديد كبرنامج نصي، حوّل النافذة إلى الوضع المتقدم (نافذة التكوين).