معلمات الخطوات
عندما تحدد خطوة، تُفتح حقولها أسفلها، حقل لكل تفصيل تحتاج إليه الخطوة. وكل حقل مسمّى بكلمات بسيطة. أشِر إلى حقل لرؤية تلميح يذكر الغرض منه.
أنواع الحقول
| الحقل | يبدو مثل | يقبل |
|---|---|---|
| نص | مربع نص | أي نص |
| عدد صحيح | مربع نص | عددًا صحيحًا، مثل 250 أو -3، أو عددًا سداسيًا عشريًا يبدأ بـ 0x، مثل 0xB3، أو ثابتًا مسمى، مثل VirtualKey.MediaPlayPause |
| رقم | مربع نص | رقمًا بنقطة كفاصلة عشرية، مثل 0.5، أيًا كان التنسيق الإقليمي لديك |
| صواب أو خطأ | مفتاح | تشغيل (true) أو إيقاف (false) |
| اختيار من قيم مسماة | قائمة منسدلة ② | أحد الأسماء المسرودة، مثل MouseButton.Primary؛ ويمكنك أيضًا الكتابة فيها |
| النافذة | مربع نص | نافذة من قائمة القيم أو من متغير، وهي عادةً النافذة الهدف |
| المفاتيح (إرسال مفاتيح) | مربع التقاط مفاتيح | مجموعة المفاتيح التي تضغطها |
في كل أنواع الحقول يمكنك أيضًا كتابة $ واسم متغير لاستخدام قيمة حفظتها خطوة سابقة (المتغيرات).
يستخدم الرقم في حقل الخطوة دائمًا النقطة كفاصلة عشرية ولا يستخدم فواصل الآلاف، أيًا كان التنسيق الإقليمي لديك.
الثوابت المسماة
يقبل حقل العدد الصحيح أو الرقم أيضًا ثابتًا مسمى: مساحة أسماء، ونقطة، واسمًا، مثل VirtualKey.MediaPlayPause أو AudioEndpoint.Playback، وهي
الأسماء نفسها التي يستخدمها البرنامج النصي (الثوابت المسماة). اكتبه تمامًا، بحالة الأحرف نفسها ودون مسافات. تحفظ
الخطوة الاسم ويستخدم الإجراء رقمه عند تشغيله. أما حقل النص فيحتفظ بهذا الاسم كالنص الذي كتبته.
حقل المفاتيح
لـ إرسال مفاتيح مربع التقاط بدلًا من مربع نص. انقر عليه (انقر لتعيين اختصار)، ثم اضغط المجموعة. لا تُسجَّل إلا المجموعة؛ ولا يُرسل شيء
أثناء ضبطها. والمفاتيح التي لا تستطيع مجموعة المفاتيح تسميتها، مثل مفاتيح الوسائط، تُرفض برسالة. ولضغطها، استخدم الخطوة ضغط مفتاح وتحريره
(KeyboardPressKey) مع اسم المفتاح، مثل VirtualKey.MediaPlayPause (وصفات عملية).
تبدأ الخطوات الجديدة مملوءة
تبدأ حقول النافذة في الخطوة الجديدة بـ النافذة الهدف: النافذة التي رُسمت الإيماءة فوقها، أو النافذة التي لها التركيز بالنسبة إلى مفتاح اختصار أو نص مكتوب. وتبدأ مفاتيحها متوقفة. ويبدأ كل حقل آخر فارغًا، لتملأه أنت.
اختيار قيمة من القائمة
لكل حقل باستثناء المفاتيح والمفاتيح الثنائية سهم صغير في نهايته (اختيار قيمة). وهو يفتح قائمة بالقيم التي تناسب الحقل ①. وإلى جانب حقول الخطوة نفسها، توجد القائمة في حقلي القيمة ومقارنةً بـ في الشرط وفي القيمة المفردة فيه (الشروط)، وفي عدد المرات في التكرار (تكرار الخطوات)، وفي القيمة في خطوة تعيين متغير (المتغيرات).
| القسم | القيم |
|---|---|
| مما بدأ الإجراء | النافذة الهدف، وعنصر التحكم الهدف، واسم الإيماءة، واسم الإجراء، واسم مجموعة التطبيقات، وزر الإيماءة، والحافة اليسرى للإيماءة والحافة العلوية للإيماءة وعرض الإيماءة وارتفاع الإيماءة |
| تُقرأ عند تشغيل الخطوة | النافذة النشطة، وموضع الماوس X، وموضع الماوس Y، ونص الحافظة، والتاريخ والوقت الحاليان |
| محفوظة بواسطة خطوات سابقة | المتغيرات التي تحفظها الخطوات الواقعة فوق هذه الخطوة |
لا تسرد القائمة إلا قيمًا من نوع الحقل: حقل الرقم يقبل أيضًا الأعداد الصحيحة، والحقل الذي يقبل أي شيء يقبلها كلها. ولا يعرض عدد المرات إلا الأعداد الصحيحة؛ أما حقول الشرط وقيمة تعيين متغير فتعرض كل القراءات. وعندما لا يناسب شيء، تذكر القائمة لا يوجد ما يمكن اختياره لهذا الحقل.
تظهر القيمة المختارة كشريحة باسمها مكان مربع النص. أشِر إلى الشريحة لرؤية ماهيتها وكيف يكتبها البرنامج النصي. ويفرغ زرها مسح الحقل لكي تتمكن من الكتابة مرة أخرى.
تقرأ القيم تحت مما بدأ الإجراء المشغِّل: بالنسبة إلى إجراء بدأه مفتاح اختصار أو نص مكتوب، تكون قيم الإيماءة فارغة أو 0. وتُعرض كل قيمة حيثما تعمل الخطوات، لأن المقتطف يمكن استدعاؤه من أي مكان.
في المفتاح الثنائي، يظهر المتغير الذي كتبته سابقًا كشريحة؛ ومسح الشريحة يوقف المفتاح.
الفحوص أثناء الكتابة
يُفحص كل حقل أثناء الكتابة. وتظهر المشكلة باللون الأحمر أسفل الحقل ويتحول إطار الحقل إلى الأحمر:
| الرسالة | المعنى |
|---|---|
| هذه القيمة مطلوبة. | اسم المتغير في خطوة تعيين متغير فارغ. |
| أدخل عددًا صحيحًا (عشريًا أو سداسي عشري بالبادئة 0x)، أو ثابتًا مسمى، أو $variable. | يحتوي حقل العدد الصحيح على شيء آخر. |
| لا يوجد ثابت مسمى بهذا الاسم. تحقق من الإملاء وحالة الأحرف، كما في VirtualKey.MediaPlayPause. | يحتوي حقل العدد الصحيح أو الرقم على مساحة أسماء ونقطة واسم ليس ثابتًا مسمى. |
| أدخل رقمًا، أو $variable. | يحتوي حقل الرقم على شيء آخر. |
| أدخل true أو false، أو $variable. | يحتوي حقل الصواب أو الخطأ المكتوب كنص على شيء آخر. |
| لا يمكن للخطوة تشغيل دالة مضمَّنة داخل وسيطة. انقلها إلى متغير أولًا. | يحتوي الحقل على استدعاء دالة مضمَّنة في أقواسه شيء (أدناه). |
ما دام حقل يحتوي على نص مكتوب يفشل في فحصه، مثل أحرف في حقل عدد صحيح أو رقم، أو اسم ليس ثابتًا مسمى، أو أي شيء غير true أو false في حقل
صواب أو خطأ، فلا تُحفظ الخطوات: يحتفظ الإجراء بآخر خطوات محفوظة، ويظهر لم يتم حفظ الخطوات: الخطوة N تحتوي على حقل غير صالح أسفل القائمة
حتى تصلح الحقل (المشكلات).
الحقل الفارغ لا يعرض أي رسالة ولا يمنع الحفظ أبدًا؛ فتُحفظ الخطوات مع الحقل فارغًا. وعندما يعمل الإجراء، فإن الخطوة التي فيها حقل رقم أو صواب أو خطأ أو نافذة فارغ توقف الإجراء هناك، وتذكر مخرجات النظام في وحدة التحكم أن تلك الوسيطة من نوع خاطئ. أما حقل النص الفارغ فيعمل كنص فارغ، وهذا يعني بالنسبة إلى بعض الدوال المضمَّنة (اسم ملف، أو عنوان نافذة للبحث عنها) أن الخطوة لا تفعل شيئًا.
النقل إلى متغير
يحتوي الحقل على قيمة، أو متغير، أو إحدى القراءات في قائمة القيم، ولا يحتوي أبدًا على استدعاء دالة مضمَّنة بوسيطات. وإذا كتبت واحدًا، مثل
WindowGetTitle($w)، يعرض الحقل نقل إلى متغير. فيضيف خطوة فوق هذه الخطوة مباشرةً تشغّل الاستدعاء وتحفظ النتيجة تحت اسم مأخوذ من الحقل (مثل
window، ثم window2)، ويضع ذلك المتغير في الحقل.
الاستدعاء الذي ليس في أقواسه شيء، مثل ClipboardGetText()، لا بأس به: فهو مثل اختيار تلك القراءة من قائمة القيم. وينطبق ذلك في كل حقل له قائمة
القيم، بما في ذلك حقول الشرط وعدد المرات وقيمة تعيين متغير.
الاحتفاظ بنتيجة الخطوة
تعطي معظم الدوال المضمَّنة نتيجة: النص الذي قرأته، أو النافذة التي وجدتها، أو ما إذا كانت قد نجحت. يحتفظ حفظ النتيجة باسم ③ بها تحت اسم، لكي
تتمكن الخطوات اللاحقة من استخدامها بصيغة $name. اتركه فارغًا لتجاهل النتيجة.
الخطوة التي تحتفظ بنتيجتها تعرض "→ $name" في نهاية ملخصها. وتتبع الأسماء القواعد الواردة في المتغيرات.
الأنواع الخاطئة وقت التشغيل
يتحقق المحرر من شكل ما تكتبه، لا من كل قاعدة في الدالة المضمَّنة. وعندما يعمل الإجراء، فإن قيمة من نوع خاطئ (مثلًا متغير يحمل نصًا حيث تحتاج دالة مضمَّنة إلى عدد صحيح) أو قيمة ترفضها الدالة المضمَّنة توقف الإجراء بخطأ في وحدة التحكم التشخيصية. راجع الأخطاء.