استخدام كتل التعليقات#
يشرح هذا الدرس كيفية استخدام كتل التعليقات في VEXcode GO. بنهاية الدرس، ستعرف لماذا وكيف تستخدم التعليقات لتوثيق مشروعك.
تتيح لك مربعات التعليقات إضافة ملاحظات مباشرةً إلى مجموعة المربعات الخاصة بك، والتي تجدها في فئة المنطق - التعليقات في صندوق الأدوات. وهي لا تؤثر على كيفية عمل مشروعك، بل هي موجودة فقط لمساعدتك أنت والآخرين على فهمه.
عند البدء :: hat events
[comment]
يستخدم المبرمجون التعليقات لتنظيم أكوادهم وتسهيل قراءتها وفهمها، سواءً لأنفسهم عند العودة إلى المشروع لاحقًا أو للآخرين العاملين عليه. اسم الكتلة البرمجية الواحدة يصف تلك الكتلة فقط، بينما يمكن للتعليق أن يصف سلوك مجموعة كاملة من الكتل دفعة واحدة، مما يتيح فهم وظيفة مجموعة الكتل بنظرة سريعة، دون الحاجة إلى قراءة كل كتلة على حدة.
على سبيل المثال، يتقدم هذا المشروع حتى يصطدم بشيء ما، ثم يتراجع. وبصياغة هذا النص، يتطلب فهمه قراءة كل فقرة على حدة.
عند البدء :: hat events
تشغيل [للأمام v]
انتظر حتى <[bumper v] مضغوط؟ :: custom-led>
إيقاف القيادة
تشغيل [للخلف v] لمسافة (100) [مم v] ▶
إضافة تعليق أعلى كل قسم يصف سلوكه، مما يجعل المشروع أسهل للفهم بنظرة سريعة.
عند البدء :: hat events
[Drive forward until something is in the way.]
تشغيل [للأمام v]
انتظر حتى <[bumper v] مضغوط؟ :: custom-led>
[Back away from the object.]
إيقاف القيادة
تشغيل [للخلف v] لمسافة (100) [مم v] ▶
After connecting your robot to VEXcode, select Start to run the project. The robot will drive forward, stop and back away once it bumps into something.