स्क्रीन#

परिचय#

screen क्लास controller क्लास की एक व्युत्पन्न क्लास है। यह V5 कंट्रोलर स्क्रीन पर टेक्स्ट, नंबर और वैल्यू प्रदर्शित करने के लिए फ़ंक्शन प्रदान करती है।

एक screen ऑब्जेक्ट को controller ऑब्जेक्ट के माध्यम से एक्सेस किया जाता है। इसे सीधे तौर पर कंस्ट्रक्ट नहीं किया जाता है।

V5 कंट्रोलर स्क्रीन में टेक्स्ट और नंबर प्रदर्शित करने के लिए 3 पंक्तियाँ और 19 कॉलम हैं।

V5 कंट्रोलर स्क्रीन का एक स्क्रीनशॉट, जिसमें प्रिंट करने योग्य क्षेत्र में पंक्तियाँ और स्तंभ दिखाए गए हैं। पंक्ति 1 का स्तंभ 1 ऊपरी बाएँ कोने से शुरू होता है और पंक्ति 3 और स्तंभ 19 निचले दाएँ कोने में हैं।

पहुँच#

controller क्लास Screen ऑब्जेक्ट प्रदान करती है। यह screen क्लास का एक इंस्टेंस है।

वस्तु

उपयोग का उदाहरण

विवरण

Screen

Controller.Screen.print(“Hello”);

V5 कंट्रोलर स्क्रीन।

नोट्स#

  • screen सदस्य फ़ंक्शन का उपयोग करने से पहले, controller ऑब्जेक्ट बनाएं।

  • कंट्रोलर स्क्रीन में 3 पंक्तियाँ और 19 स्तंभ हैं।

  • कर्सर की स्थिति यह निर्धारित करती है कि अगला मुद्रित मान कहाँ दिखाई देगा।

// Create a Controller object
controller Controller = controller();

सदस्य कार्य#

screen क्लास में निम्नलिखित सदस्य फ़ंक्शन शामिल हैं:

कार्य — टेक्स्ट प्रदर्शित करें या कंट्रोलर स्क्रीन साफ़ करें।

  • print — नियंत्रक स्क्रीन पर स्वरूपित पाठ, संख्याएँ या मान प्रदर्शित करता है।

  • setCursor — कर्सर को निर्दिष्ट पंक्ति और स्तंभ पर ले जाता है।

  • newLine — वर्तमान पंक्ति के शेष भाग को साफ़ करता है और कर्सर को अगली पंक्ति में ले जाता है।

  • clearScreen — कंट्रोलर स्क्रीन साफ़ करता है।

  • clearLine — कंट्रोलर स्क्रीन पर एक पंक्ति साफ़ करता है।

गेटर्स — वर्तमान कर्सर स्थिति पढ़ें।

  • row — वर्तमान कर्सर पंक्ति लौटाता है।

  • column — वर्तमान कर्सर कॉलम लौटाता है।

कार्रवाई#

print#

print वर्तमान कर्सर स्थिति पर V5 कंट्रोलर स्क्रीन पर स्वरूपित पाठ, संख्याएँ या मान प्रदर्शित करता है।

उपलब्ध कार्य

void print(
  const char* format,
  ...
);

void print(
  char* format,
  ...
);

पैरामीटर

प्रकार

विवरण

format

const char*

एक फॉर्मेट स्ट्रिंग जो स्ट्रिंग लिटरल या रीड-ओनली सी-स्टाइल स्ट्रिंग के रूप में प्रदान की जाती है, जैसे कि “Score: %d”.

format

char*

एक प्रारूप स्ट्रिंग जिसे एक संशोधनीय वर्ण सरणी के रूप में प्रदान किया गया है।

…

वैकल्पिक। प्रारूप स्ट्रिंग में अल्पविराम से अलग किए गए एक या अधिक अतिरिक्त मान डाले जाते हैं।

वापसी मूल्य

इस कार्य पर कीमत के लिहाज से कुछ भी रिटर्न नहीं मिलता है।

टिप्पणियाँ

  • आउटपुट कंट्रोलर स्क्रीन पर वर्तमान कर्सर स्थिति से शुरू होता है।

  • फॉर्मेट स्ट्रिंग का उपयोग करते समय, पास किए गए मानों की संख्या और प्रकार स्ट्रिंग में फॉर्मेट स्पेसिफायर से मेल खाना चाहिए।

उदाहरण

// Display a message at the starting cursor position
Controller.Screen.print("Hello, Robot!");

// Display a formatted number
Controller.Screen.print("Score: %d", 25);

setCursor#

setCursor का उपयोग करने कर्सर V5 कंट्रोलर स्क्रीन पर निर्दिष्ट पंक्ति और स्तंभ पर चला जाता है। अगला मुद्रित मान उसी स्थान पर दिखाई देगा।

उपलब्ध फ़ंक्शन

void setCursor(
  int32_t row,
  int32_t col
);

पैरामीटर

प्रकार

विवरण

row

int32_t

वह पंक्ति संख्या जहाँ कर्सर रखा जाएगा, 1 से 3 तक।

col

int32_t

वह कॉलम संख्या जहां कर्सर रखा जाएगा, 1 से 19 तक।

वापसी मूल्य

इस कार्य पर कीमत के लिहाज से कुछ भी रिटर्न नहीं मिलता है।

उदाहरण

// Display text starting at row 2, column 3
Controller.Screen.setCursor(2, 3);
Controller.Screen.print("Row 2, Column 3");

newLine#

newLine वर्तमान पंक्ति के शेष भाग को साफ़ करता है और कर्सर को V5 कंट्रोलर स्क्रीन की अगली पंक्ति में कॉलम 1 पर ले जाता है।

उपलब्ध फ़ंक्शन

void newLine();

पैरामीटर

इस फ़ंक्शन में कोई पैरामीटर नहीं है।

वापसी मूल्य

इस कार्य पर कीमत के लिहाज से कुछ भी रिटर्न नहीं मिलता है।

उदाहरण

// Display two lines of text
Controller.Screen.print("Line 1");
Controller.Screen.newLine();
Controller.Screen.print("Line 2");

clearScreen#

clearScreen V5 कंट्रोलर स्क्रीन से सभी टेक्स्ट को साफ़ कर देता है।

उपलब्ध फ़ंक्शन

void clearScreen();

पैरामीटर

इस फ़ंक्शन में कोई पैरामीटर नहीं है।

वापसी मूल्य

इस कार्य पर कीमत के लिहाज से कुछ भी रिटर्न नहीं मिलता है।

उदाहरण

// Clear the Controller screen after 2 seconds
Controller.Screen.print("VEXcode");
wait(2, seconds);
Controller.Screen.clearScreen();

clearLine#

clearLine V5 कंट्रोलर स्क्रीन पर एक पंक्ति साफ़ करता है।

उपलब्ध कार्य

void clearLine(
  int line
);

void clearLine();

पैरामीटर

प्रकार

विवरण

line

int

वैकल्पिक। 1 से 3तक की पंक्ति को साफ़ करें। यदि कोई पंक्ति प्रदान नहीं की जाती है, तो वर्तमान पंक्ति साफ़ कर दी जाती है।

वापसी मूल्य

इस कार्य पर कीमत के लिहाज से कुछ भी रिटर्न नहीं मिलता है।

टिप्पणियाँ

  • किसी पंक्ति को साफ़ करने से वर्तमान कर्सर की स्थिति नहीं बदलती है।

उदाहरण

// Display text on two rows
Controller.Screen.print("This text stays");
Controller.Screen.newLine();
Controller.Screen.print("This disappears");

// Wait 3 seconds before clearing row 2
wait(3, seconds);
Controller.Screen.clearLine(2);

टिककर खेल#

row#

row V5 कंट्रोलर स्क्रीन पर वर्तमान कर्सर पंक्ति लौटाता है।

उपलब्ध फ़ंक्शन

int32_t row();

पैरामीटर

इस फ़ंक्शन में कोई पैरामीटर नहीं है।

वापसी मूल्य

यह int32_t लौटाता है जो वर्तमान कर्सर पंक्ति को दर्शाता है। पंक्ति क्रमांकन 1 से शुरू होता है।

उदाहरण

// Display the cursor's current row
Controller.Screen.setCursor(3, 2);
Controller.Screen.print(Controller.Screen.row());

column#

column V5 कंट्रोलर स्क्रीन पर वर्तमान कर्सर कॉलम लौटाता है।

उपलब्ध फ़ंक्शन

int32_t column();

पैरामीटर

इस फ़ंक्शन में कोई पैरामीटर नहीं है।

वापसी मूल्य

यह int32_t लौटाता है जो वर्तमान कर्सर कॉलम को दर्शाता है। कॉलम नंबरिंग 1 से शुरू होती है।

उदाहरण

// Display the cursor's current column
Controller.Screen.setCursor(3, 2);
Controller.Screen.print(Controller.Screen.column());