المقتطفات
المقتطف جزء مسمى من الخطوات أو البرنامج النصي غير مرتبط بأي مشغِّل. تشغّله بالاسم الإجراءاتُ، والبرامج النصية السابقة واللاحقة، والأحداث العامة، والمقتطفات الأخرى. اكتب شيئًا مرة واحدة كمقتطف، فيستخدم كل إجراء يستدعيه النسخة نفسها: غيّر المقتطف، فتتغير كلها.
قائمة المقتطفات
تعرض القائمة كل مقتطف في المكتبة، تحت عنوان لكل فئة: الفئات أبجديًا، ثم بلا فئة، وأبجديًا حسب الاسم داخل كل فئة. ويعرض المقتطف الذي يستدعيه شيء ما تستخدمها وعدد المستدعين.
- يضيف + جديد مقتطفًا باسم مقتطف جديد في فئة المقتطف المحدد، مكتوبًا كخطوات.
- ينسخ زر التكرار بجانب + جديد المقتطف المحدد باسم جديد فريد.
- يحذف زر الحذف في صف مقتطفًا (حذف مقتطف).
الاسم والفئة
- الاسم ① هو ما يجد به المستدعون المقتطف. يجب أن يكون فريدًا في المكتبة كلها، أيًا كانت الفئة، والاسمان اللذان لا يختلفان إلا في حالة الأحرف يُحتسبان الاسم نفسه. ولا يمكن أن يحتوي على علامة اقتباس مزدوجة أو شرطة مائلة عكسية أو حرف تحكم. والاسم الذي يخالف قاعدة يظهر باللون الأحمر مع السبب، ويعود إلى الاسم القديم عند مغادرة المربع.
- إعادة تسمية مقتطف تعيد كتابة كل استدعاء يسمّيه بين علامتي اقتباس، في كل مكان في تكوينك (من يستدعي مقتطفًا).
- الفئة ② لا تفعل سوى تجميع القائمة. ولا تغيّر طريقة عمل المقتطف.
ما يفعله المقتطف
يختار مكتوب بصيغة خطوات أو برنامج نصي، كما في الإجراء (الخطوات والبرنامج النصي وAutoHotkey). ويعرض التبديل من الخطوات إلى البرنامج النصي ترجمة الخطوات، كما يفعل في صفحة الإجراءات.
- في الخطوات، المحرر هو نفسه محرر الإجراء (محرر الخطوات).
- في البرنامج النصي، يفحص التحقق من البنية البرنامج النصي بالمترجم الخاص بالمحرك. ويبلغ عن التحليل سليم مع عدد الأسطر، أو عن الخطأ الأول، ويضع خطًا تحت المشكلة في المحرر.
- لا يُعرض AutoHotkey إلا لمقتطف يعمل بالفعل كـ AutoHotkey.
- لا يوجد زر لتشغيل مقتطف هنا. لتجربة الخطوات بأمان، استخدم بيئة التجربة.
الوضع المتقدم. فوق المحرر، يظهر الاستدعاء الذي يشغّل هذا المقتطف ③ بصيغة البرنامج النصي، مع زر ينسخه.
استدعاء مقتطف
يعمل المقتطف عندما تستدعي خطوة أو برنامج نصي الدالة المضمَّنة SnippetExecuteScript باسمه:
- في الخطوات، أضف خطوة تشغيل مقتطف (
SnippetExecuteScript) من قائمة كل الدوال المضمَّنة (إضافة الخطوات) واكتب اسم المقتطف في الاسم الخاص بها. - في البرنامج النصي، اكتب الاستدعاء:
SnippetExecuteScript("Center window");
كيف يعمل:
- ينتظر المستدعي حتى ينتهي المقتطف، ثم يتابع.
- يرى المقتطف ما بدأ المستدعي (نافذته الهدف، وإيماءته، وما إلى ذلك)، لذا فإن النافذة الهدف داخل مقتطف هي النافذة الهدف للمستدعي.
- للمقتطف متغيراته الخاصة. لا يمكنه قراءة متغيرات المستدعي، ولا يمكن للمستدعي قراءة متغيراته.
- يجب أن يتطابق الاسم تمامًا، بما في ذلك حالة الأحرف. وإذا لم يكن لأي مقتطف هذا الاسم، فلا يعمل شيء ويعطي الاستدعاء
false. - لا يعطي الاستدعاء
trueإلا عندما يعمل المقتطف حتى النهاية. ويعطي أيضًاfalseعندما يكون المقتطف فارغًا، أو فيه خطأ، أو يُوقف. - يمكن لمقتطف أن يستدعي مقتطفات أخرى. ولا شيء يمنع مقتطفًا من استدعاء نفسه، لذا تأكد من أن مثل هذه السلسلة تنتهي.
من يستدعي مقتطفًا
تسرد البطاقة يستدعيه ④ كل إجراء، وبرنامج نصي سابق أو لاحق، وحدث عام (حتى المتوقف منه)، ومقتطف يستدعي هذا المقتطف. ويُعلَّم الحدث العام بـ حدث عام، والمقتطف بـ مقتطف.
لا يُعثر إلا على الاستدعاءات التي تكتب اسم المقتطف كاملًا بين علامتي اقتباس. والاستدعاء الذي يبني الاسم أثناء تشغيله لا يُسرد، أما الاستدعاء داخل تعليق فيُسرد. ولا يُبحث في متون AutoHotkey.
حذف مقتطف
لا يمكنك حذف مقتطف ما دام أي شيء مسرود تحت يستدعيه لا يزال يستدعيه. عندئذٍ يعرض زر الحذف يتعذّر حذف مع قائمة المستدعين؛ غيّر تلك الاستدعاءات أو أزلها أولًا. والمقتطف الذي لا يستدعيه شيء يُحذف بعد تأكيد.
الاستدعاء الذي لا تراه القائمة (اسم يُبنى أثناء تشغيل البرنامج النصي) غير محمي: إذا حذفت ذلك المقتطف، فلا يجد الاستدعاء شيئًا
ويعطي false.
مقتطفات من أماكن أخرى
- يحوّل إنشاء مقتطف في صفحة المسجِّل تسجيلًا إلى مقتطف.
- يحفظ حفظ كمقتطف في صفحة بيئة التجربة الخطوات أو البرنامج النصي الذي جربته هناك.
كلاهما يفتح المقتطف الجديد في هذه الصفحة والمؤشر في الاسم الخاص به، جاهزًا لإعادة التسمية. ويُضاف إلى الاسم المستخدم
بالفعل -1 و-2 وهكذا.