العلاماتُ التي نَحتاجُهَا في كتابة الوظائف
%
بالمِئَة.
هذه العَلَامَةُ نَضَعُها قَبْلَ استدعاءِ وظيفةٍ أساسيةٍ في التطبيق. أو إضافة, أو أداة.
ولا حاجةَ لنا بكتابتها إذا اخترنا إدراج, عن طريقِ المزيدِ مِنَ الخَيَارَات.
أمثلةٌ بالترتيبِ السابق.
المثالُ الأول.
if service.click({{"%إسم الوظيفة",}})return true end
المثالُ الثاني.
if service.click({{"%Plugins/إسم الإضافة",}})return true end
المثالُ الثالث.
if service.click({{"%Tools/إسم الأداة",}})return true end
مُلاحظة.
*
نجمة.
هذه العَلامَةُ نَضَعُها لحصر الجملة أَوِ الكلمة وَهَذا لِنَتَخَلَّصَ مِنَ المتغيرات.
عندنا ثلاثُ حالات.
الحالةُ الأولى.
عندنا رِسالةٌ واحدةٌ غيرُ مقروءة, وعندنا ثلاثُ رسائلَ غيرُ مقروءة.
فالثابتُ هنا عِبَارَة: غيرُ مقروءة. والمتغيرُ هو العدد.
فهنا نَسْتَخْدِمُ عِبارةَ غيرَ مقروءة, وَنضَعُ عَلَامَةَ النجمةِ قَبْلَها لكي يبحثَ الناطقُ عَنِ الْعِبارة,وَيَضْغَطَ عليها حتى لو كان قَبْلَها نص.
مثال.
if service.click({{"*غير مقروءة",}})return true end
الحالةُ الثَّانِيَة.
عندنا مكالمةٌ صوتية, وعندنا مكالمةُ فديو.
فالثابتُ هنا كَلِمَةُ مكالمة, والمتغيرُ صوتية, أو فديو.
فهنا نَسْتَخْدِمُ كلمةَ مكالمة, وَنضَعُ عَلَامَةَ النجمةِ بعدَها لكي يبحثَ الناطقُ عَنِ الكلمة, وَيَضْغَطَ عليها حتى لو كان بعدها نص.
مثال.
if service.click({{"مكالمة*",}})return true end
الحالةُ الثالثة.
عندنا إغلاقُ جميعِ التطبيقات, وعندنا مَسْحُ جميعِ المحادثات, وعندنا حَذْفُ جميعِ الإشعارات.
فَكُلُّ ما في هَذهِ الْجُمَلِ متغير, سوى كَلِمَةِ جميع.
فهنا نَسْتَخْدِمُ كلمةَ جميع, وَنَضَعُها بَيْنَ عَلَمَتَيِ النجمة, لكي يبحثَ الناطقُ عَنِ الكلمة, وَيَضْغَطَ عليها حتى لو كان قَبْلَها أو بعدها نص.
if service.click({{"*جميع*",}})return true end
ملاحظات.
أولا. العِباراتُ أََوِ الجُمَلُ أَوِ الكلمات, نقصدُ بها ما هو موجودٌ في التركيز. سواءً كان زِرًّا أو نَصًّا أو نحوَ ذلك.
ثانيًا. القواعدُ المذكورةُنستطيعُ تطبيقَها على جزء مِنَ الكلمة. كَأَنْ نَضَعَ عِبارةَ مِي بينَنَجْمَتَيْن. وَهَذِهِ العبارةُ موجودَةٌ في كلمةِ جميع. لكنَّ الأمرَ ليس عمليا لِأَنَّ الميمَ مَعَ الياءِ نَجِدُهُما في الكثيرِ مِنَ الكلمات. وَرُبَّما نحتاجُ إلى هذا الأَمْرِ في الحالاتِ الشاذَّةِ فقط.
الحالةُ الثالثة.
#
عَلَامَةُ المُرَبَّع.
هذه العلامَةُ نَضَعُها قَبْلَ إِسْمِ الزِّرِّ القابلِ لِلتصنيفْ, أو قَبْلَ إِسْمِ الْعُقْدَة, أو قَبْلَ إسْمِ الحُزمةِ معَ إسْمِ الْعُقْدَة. (viewIdResName)
مثال.
if service.click({{"#voice_note_btn",}})return true end
if service.click({{"#com.whatsapp:id/voice_note_btn",}})return true end
وَنَضَعُها بعدَ إسْمِ الزِّرِّ بِكُلِّ أنواعِهِ للترتيب. وذَلِكَ إذا كان هذا الزِّرُّ موجودا في النافذةِ الحاليةِ أكثرَ مِنْ مرةٍ بِنَفسِ الإسْم.
إنَّ زرَّ تشغيلْ في محادَثاتْ WhatsApp يوجدُ أكثرَ من مرة.
فإذأ أردنا الترتيبَ مِنَ الأولِ للأخير, فإننا نَضَعُ عَلامَةَ المُرَبَّعْ, ونَضَعُ بعدَها رقمَ الترتيب.
وإذأ أردنا الترتيبَ مِنَ الأخيرِ لِلْأولْ,فإننا نَضَعُ عَلامَةَ المُرَبَّعْ, ونَضَعُ بعدَها عَلامَةَ الناقص, ونَضَعُ بعدَهُما رَقْمَ الترتيب.
أمثِلَةُ الترتيبِ مِنَ الأولِ للأخير.
if service.click({{"#voice_note_btn#1",}})return true end
if service.click({{"#voice_note_btn#2",}})return true end
if service.click({{"تشغيل#1",}})return true end
if service.click({{"تشغيل#2",}})return true end
أمْثِلةُ الترتيبِ مِنَ الأخيرِ لِلْأولْ.
if service.click({{"#voice_note_btn#-1",}})return true end
if service.click({{"#voice_note_btn#-2",}})return true end
if service.click({{"تشغيل#-1",}})return true nd
if service.click({{"تشغيل#-2",}})return true end
مُلاحظة.
عندما يكونُ هناك زِرٌّ في نافذةٍ مُعَيَّنَةٍ أكثرَ من مرة, فإنهُ إفْتِرَاضِيًّا يَضْغَطُ على آخِرِ زِرْ.
فالثابتُ هنا كَلِمَةُ مكالمة, والمتغيرُ صوتية, أو فديو.
>
أكبرْ مِنْ.
هذه العلامَةُ نَضَعُها قَبْلَ إسمِ التطبيق لِفَتْحِه.
وإذا اخترنا فَتْحَ تطبيقٍ عن طريقِ إدراج فتح تطبيقْ, فلا حاجةَ لنا بها.
مثال.
if service.click({{">Acapela TTS Voices",}})return true end
وَنَضَعُها بعدَ إسْمِ زِرْ, أو فَتْحِ تطبيق, وَنَضَعُ بعدَها مُدَّةً مُعَيَّنَة, وذَلِكَ للإنتظار.
%
بالمِئَة.
هذه العَلَامَةُ نَضَعُها قَبْلَ استدعاءِ وظيفةٍ أساسيةٍ في التطبيق. أو إضافة, أو أداة.
ولا حاجةَ لنا بكتابتها إذا اخترنا إدراج, عن طريقِ المزيدِ مِنَ الخَيَارَات.
أمثلةٌ بالترتيبِ السابق.
المثالُ الأول.
if service.click({{"%إسم الوظيفة",}})return true end
المثالُ الثاني.
if service.click({{"%Plugins/إسم الإضافة",}})return true end
المثالُ الثالث.
if service.click({{"%Tools/إسم الأداة",}})return true end
مُلاحظة.
*
نجمة.
هذه العَلامَةُ نَضَعُها لحصر الجملة أَوِ الكلمة وَهَذا لِنَتَخَلَّصَ مِنَ المتغيرات.
عندنا ثلاثُ حالات.
الحالةُ الأولى.
عندنا رِسالةٌ واحدةٌ غيرُ مقروءة, وعندنا ثلاثُ رسائلَ غيرُ مقروءة.
فالثابتُ هنا عِبَارَة: غيرُ مقروءة. والمتغيرُ هو العدد.
فهنا نَسْتَخْدِمُ عِبارةَ غيرَ مقروءة, وَنضَعُ عَلَامَةَ النجمةِ قَبْلَها لكي يبحثَ الناطقُ عَنِ الْعِبارة,وَيَضْغَطَ عليها حتى لو كان قَبْلَها نص.
مثال.
if service.click({{"*غير مقروءة",}})return true end
الحالةُ الثَّانِيَة.
عندنا مكالمةٌ صوتية, وعندنا مكالمةُ فديو.
فالثابتُ هنا كَلِمَةُ مكالمة, والمتغيرُ صوتية, أو فديو.
فهنا نَسْتَخْدِمُ كلمةَ مكالمة, وَنضَعُ عَلَامَةَ النجمةِ بعدَها لكي يبحثَ الناطقُ عَنِ الكلمة, وَيَضْغَطَ عليها حتى لو كان بعدها نص.
مثال.
if service.click({{"مكالمة*",}})return true end
الحالةُ الثالثة.
عندنا إغلاقُ جميعِ التطبيقات, وعندنا مَسْحُ جميعِ المحادثات, وعندنا حَذْفُ جميعِ الإشعارات.
فَكُلُّ ما في هَذهِ الْجُمَلِ متغير, سوى كَلِمَةِ جميع.
فهنا نَسْتَخْدِمُ كلمةَ جميع, وَنَضَعُها بَيْنَ عَلَمَتَيِ النجمة, لكي يبحثَ الناطقُ عَنِ الكلمة, وَيَضْغَطَ عليها حتى لو كان قَبْلَها أو بعدها نص.
if service.click({{"*جميع*",}})return true end
ملاحظات.
أولا. العِباراتُ أََوِ الجُمَلُ أَوِ الكلمات, نقصدُ بها ما هو موجودٌ في التركيز. سواءً كان زِرًّا أو نَصًّا أو نحوَ ذلك.
ثانيًا. القواعدُ المذكورةُنستطيعُ تطبيقَها على جزء مِنَ الكلمة. كَأَنْ نَضَعَ عِبارةَ مِي بينَنَجْمَتَيْن. وَهَذِهِ العبارةُ موجودَةٌ في كلمةِ جميع. لكنَّ الأمرَ ليس عمليا لِأَنَّ الميمَ مَعَ الياءِ نَجِدُهُما في الكثيرِ مِنَ الكلمات. وَرُبَّما نحتاجُ إلى هذا الأَمْرِ في الحالاتِ الشاذَّةِ فقط.
الحالةُ الثالثة.
#
عَلَامَةُ المُرَبَّع.
هذه العلامَةُ نَضَعُها قَبْلَ إِسْمِ الزِّرِّ القابلِ لِلتصنيفْ, أو قَبْلَ إِسْمِ الْعُقْدَة, أو قَبْلَ إسْمِ الحُزمةِ معَ إسْمِ الْعُقْدَة. (viewIdResName)
مثال.
if service.click({{"#voice_note_btn",}})return true end
if service.click({{"#com.whatsapp:id/voice_note_btn",}})return true end
وَنَضَعُها بعدَ إسْمِ الزِّرِّ بِكُلِّ أنواعِهِ للترتيب. وذَلِكَ إذا كان هذا الزِّرُّ موجودا في النافذةِ الحاليةِ أكثرَ مِنْ مرةٍ بِنَفسِ الإسْم.
إنَّ زرَّ تشغيلْ في محادَثاتْ WhatsApp يوجدُ أكثرَ من مرة.
فإذأ أردنا الترتيبَ مِنَ الأولِ للأخير, فإننا نَضَعُ عَلامَةَ المُرَبَّعْ, ونَضَعُ بعدَها رقمَ الترتيب.
وإذأ أردنا الترتيبَ مِنَ الأخيرِ لِلْأولْ,فإننا نَضَعُ عَلامَةَ المُرَبَّعْ, ونَضَعُ بعدَها عَلامَةَ الناقص, ونَضَعُ بعدَهُما رَقْمَ الترتيب.
أمثِلَةُ الترتيبِ مِنَ الأولِ للأخير.
if service.click({{"#voice_note_btn#1",}})return true end
if service.click({{"#voice_note_btn#2",}})return true end
if service.click({{"تشغيل#1",}})return true end
if service.click({{"تشغيل#2",}})return true end
أمْثِلةُ الترتيبِ مِنَ الأخيرِ لِلْأولْ.
if service.click({{"#voice_note_btn#-1",}})return true end
if service.click({{"#voice_note_btn#-2",}})return true end
if service.click({{"تشغيل#-1",}})return true nd
if service.click({{"تشغيل#-2",}})return true end
مُلاحظة.
عندما يكونُ هناك زِرٌّ في نافذةٍ مُعَيَّنَةٍ أكثرَ من مرة, فإنهُ إفْتِرَاضِيًّا يَضْغَطُ على آخِرِ زِرْ.
فالثابتُ هنا كَلِمَةُ مكالمة, والمتغيرُ صوتية, أو فديو.
>
أكبرْ مِنْ.
هذه العلامَةُ نَضَعُها قَبْلَ إسمِ التطبيق لِفَتْحِه.
وإذا اخترنا فَتْحَ تطبيقٍ عن طريقِ إدراج فتح تطبيقْ, فلا حاجةَ لنا بها.
مثال.
if service.click({{">Acapela TTS Voices",}})return true end
وَنَضَعُها بعدَ إسْمِ زِرْ, أو فَتْحِ تطبيق, وَنَضَعُ بعدَها مُدَّةً مُعَيَّنَة, وذَلِكَ للإنتظار.