การใช้บล็อกแสดงความคิดเห็น#

Using Comment Blocks

บทช่วยสอนนี้จะอธิบายวิธีการใช้บล็อกความคิดเห็นใน 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] ▶

หลังจาก เชื่อมต่อหุ่นยนต์ของคุณกับ VEXcode ให้เลือก เริ่ม เพื่อเรียกใช้โปรเจกต์ หุ่นยนต์จะขับเคลื่อนไปข้างหน้า หยุด และถอยหลังเมื่อชนกับสิ่งใดสิ่งหนึ่ง

ภาพหน้าจอของแถบเครื่องมือ VEXcode GO โดยไฮไลต์ปุ่ม Start