क्यूटी। एक ग्राफिकल एप्लिकेशन के लिए कंसोल विजेट बनाना

अच्छे लोगों को नमस्कार।
इस शीर्षक को पढ़ते समय, पाठक सोच सकते हैं: कंसोल और ग्राफ़िकल एप्लिकेशन को क्यों मिलाएँ - GUI एप्लिकेशन में कंसोल की आवश्यकता नहीं है। लेकिन नहीं, मैं कहने की हिम्मत करता हूं। कभी-कभी, सुविधाजनक नेविगेशन के लिए कमांड और ग्राफ़िकल डिस्प्ले के पूरे सेट के साथ एक कार्यात्मक कंसोल को संयोजित करने और डेटा देखने के लिए एक शक्तिशाली उपकरण हो सकता है।
और मेरे पास एक उदाहरण है।
अपनी परियोजनाओं के लिए रेडिस फास्ट की-वैल्यू डेटा वेयरहाउस का उपयोग करना शुरू करते हुए, मैंने पाया कि फिलहाल रेडिस डेटाबेस को देखने, संपादित करने और प्रशासित करने के लिए एक भी डेस्कटॉप डेस्कटॉप एप्लीकेशन नहीं है। डेवलपर्स से केवल एक कंसोल है, रेडिस एडमिन यूआई वेब इंटरफ़ेस, जिसे अपने काम के लिए .NET की आवश्यकता होती है (जो अपने आप में पहले से ही डरा रहा है) और रूबी अनुप्रयोगों के एक जोड़े को, यह जल्दबाजी में, घुटने पर लगता है।
मैं कुछ सुविधाजनक और तेज़ करना चाहूंगा, जैसे कि रेडिस डेटाबेस। इसलिए, मैंने इस अंतर को भरने और ऐसा उपकरण लिखने का फैसला किया। जब से आपको तेजी की आवश्यकता है - तब सी ++, जब से आपको क्रॉस-प्लेटफॉर्म की आवश्यकता होती है - तब क्यूटी।



इस तथ्य के कारण कि आप सभी डेटाबेस सुविधाओं को लागू नहीं कर सकते हैं, और वे हर दिन नए दिखाई दे सकते हैं, आपको ग्राफिकल इंटरफ़ेस में एक कंसोल जोड़ना होगा। Qt में किस विजेट के आधार पर इसे अनुकरण करने के लिए, और कैसे, और मैं आपको बताना चाहता हूं।

अधर्म से लेकर कुल नियंत्रण तक

बेस कंसोल विजेट के लिए, मैंने QPlainTextEdit को चुना। सबसे पहले, इसमें उन्नत पाठ संपादन क्षमताएं शामिल हैं जिनकी हमें आवश्यकता हो सकती है, और दूसरी बात, यह आपको स्वरूपण जोड़ने की अनुमति देता है: रंग के साथ विभिन्न तत्वों को उजागर करने से हमें चोट नहीं पहुंचेगी।

तो, QPlainTextEdit का वंशज बनाएं।

class Console : public QPlainTextEdit{}; 

इस तथ्य के बावजूद कि QPlainTextEdit QTextEdit का एक सरलीकृत संस्करण है, यह उपयोगकर्ता को कई कार्यों को करने की अनुमति देता है जो एक सभ्य कंसोल के लिए स्वीकार्य नहीं हैं।

इसलिए, पहली चीज जो हम करेंगे, वह सब कुछ सीमित करना है जो संभव है। हम पूरी तरह से अधर्म से लेकर कुल नियंत्रण में हैं।

ऐसा करने के लिए, किस्ट्रोक्स और माउस क्लिक प्राप्त करने वाले अंतर्निहित स्लॉट्स को फिर से परिभाषित करें:

 void Console::keyPressEvent(QKeyEvent *){} void Console::mousePressEvent(QMouseEvent *){} void Console::mouseDoubleClickEvent(QMouseEvent *){} void Console::contextMenuEvent(QContextMenuEvent *){} 

इन पंक्तियों के बाद, उपयोगकर्ता न तो विजेट क्षेत्र में एक चरित्र दर्ज कर सकता है, न ही पाठ का एक टुकड़ा चुन सकता है, या एक पंक्ति को हटा सकता है - पूर्ण अवरुद्ध।

उदारीकरण का दौर

अब हम कुल प्रतिबंध से एक उचित लोकतंत्र की ओर बढ़ते हैं, जबकि साथ ही साथ हर उस चीज का समाधान करते हैं जिसकी जरूरत है।

पहली बात यह है कि प्रॉम्प्ट लाइन को परिभाषित करें:

 // class definition QString prompt; // contructor prompt = "redis> "; 

और प्रांप्ट लाइन को कंसोल पर प्रिंट करें:

 // constructor insertPrompt(false); // source void Console::insertPrompt(bool insertNewBlock) { if(insertNewBlock) textCursor().insertBlock(); textCursor().insertText(prompt); } 

यह आवश्यक है कि माउस से क्लिक करने पर कर्सर को पुनर्व्यवस्थित करना असंभव था, लेकिन कंसोल को सक्रिय करना संभव था:

 void Console::mousePressEvent(QMouseEvent *) { setFocus(); } 

साधारण अक्षरों, संख्याओं और अन्य उपयोगी अक्षरों को दर्ज करते समय, उन्हें कमांड लाइन में जोड़ा जाना चाहिए:

 void Console::keyPressEvent(QKeyEvent *event) { // … if(event->key() >= 0x20 && event->key() <= 0x7e && (event->modifiers() == Qt::NoModifier || event->modifiers() == Qt::ShiftModifier)) QPlainTextEdit::keyPressEvent(event); // … } 

बैकस्पेस कुंजी का उपयोग करके प्रतीकों को मिटाया जा सकता है, लेकिन सभी नहीं, लेकिन केवल एक निश्चित बिंदु तक - इसलिए, भगवान न करे, आमंत्रण रेखा खो नहीं है:

 void Console::keyPressEvent(QKeyEvent *event) { // … if(event->key() == Qt::Key_Backspace && event->modifiers() == Qt::NoModifier && textCursor().positionInBlock() > prompt.length()) QPlainTextEdit::keyPressEvent(event); // … } 

कमांड को इनपुट करने के लिए विजेट की प्रतिक्रिया निर्धारित करें (जब आप Enter दबाते हैं):

 void Console::keyPressEvent(QKeyEvent *event) { // … if(event->key() == Qt::Key_Return && event->modifiers() == Qt::NoModifier) onEnter(); // … } 

कमांड में प्रवेश करते समय, हमने प्रॉम्प्ट लाइन से टेक्स्ट ब्लॉक के अंत में टेक्स्ट का एक टुकड़ा काट दिया और एक सिग्नल का उत्सर्जन करते हैं, जिससे आप स्लॉट संलग्न कर सकते हैं:

 void Console::onEnter() { if(textCursor().positionInBlock() == prompt.length()) { insertPrompt(); return; } QString cmd = textCursor().block().text().mid(prompt.length()); emit onCommand(cmd); } 

इसके अलावा, जब एप्लिकेशन कमांड को संसाधित कर रहा है, तो टेक्स्ट फ़ील्ड को ब्लॉक करने के लिए चेकबॉक्स सेट करें।

 void Console::onEnter() { // … isLocked = true; } void Console::keyPressEvent(QKeyEvent *event) { if(isLocked) return; // … } 

आवेदन - विजेट के माता-पिता कमांड को संसाधित करेंगे और कंसोल को निष्पादन का परिणाम पारित करेंगे, जिससे इसे अनलॉक किया जाएगा:

 void Console::output(QString s) { textCursor().insertBlock(); textCursor().insertText(s); insertPrompt(); isLocked = false; } 

टीम का इतिहास

मैं चाहूंगा कि सभी दर्ज किए गए आदेशों का इतिहास सहेजा जाए और जब आप ऊपर / नीचे कुंजियों को दबाएंगे तो इसके माध्यम से नेविगेट करना संभव होगा:

 // class definition QStringList *history; int historyPos; // source void Console::keyPressEvent(QKeyEvent *event) { // … if(event->key() == Qt::Key_Up && event->modifiers() == Qt::NoModifier) historyBack(); if(event->key() == Qt::Key_Down && event->modifiers() == Qt::NoModifier) historyForward(); } void Console::onEnter() { // … historyAdd(cmd); // … } void Console::historyAdd(QString cmd) { history->append(cmd); historyPos = history->length(); } void Console::historyBack() { if(!historyPos) return; QTextCursor cursor = textCursor(); cursor.movePosition(QTextCursor::StartOfBlock); cursor.movePosition(QTextCursor::EndOfBlock, QTextCursor::KeepAnchor); cursor.removeSelectedText(); cursor.insertText(prompt + history->at(historyPos-1)); setTextCursor(cursor); historyPos--; } void Console::historyForward() { if(historyPos == history->length()) return; QTextCursor cursor = textCursor(); cursor.movePosition(QTextCursor::StartOfBlock); cursor.movePosition(QTextCursor::EndOfBlock, QTextCursor::KeepAnchor); cursor.removeSelectedText(); if(historyPos == history->length() - 1) cursor.insertText(prompt); else cursor.insertText(prompt + history->at(historyPos + 1)); setTextCursor(cursor); historyPos++; } 

सुंदर बनाना: सांत्वना रंग

ऐसा करने के लिए, विजेट कंस्ट्रक्टर में, हम कंसोल के लिए सामान्य रंग सरगम ​​को परिभाषित करते हैं - पृष्ठभूमि काली है, इनपुट कमांड के अक्षर हरे हैं:

 QPalette p = palette(); p.setColor(QPalette::Base, Qt::black); p.setColor(QPalette::Text, Qt::green); setPalette(p); 

जब शीघ्र स्ट्रिंग प्रदर्शित होती है, तो हम फ़ॉन्ट को हरे रंग में बनाते हैं:

 void Console::insertPrompt(bool insertNewBlock) { // … QTextCharFormat format; format.setForeground(Qt::green); textCursor().setBlockCharFormat(format); // … } 

और कमांड के परिणाम को आउटपुट करते समय, हम एक सफेद फ़ॉन्ट बनाते हैं:

 void Console::output(QString s) { // … QTextCharFormat format; format.setForeground(Qt::white); textCursor().setBlockCharFormat(format); // … } 

सब नीचे!

मैं यह भी चाहूंगा कि जब उपयोगकर्ता एक कमांड में प्रवेश करता है, तो कंसोल टेक्स्ट फ़ील्ड का स्क्रॉलबार बहुत नीचे तक स्क्रॉल किया जाता है:

 void Console::insertPrompt(bool insertNewBlock) { // … scrollDown(); } void Console::scrollDown() { QScrollBar *vbar = verticalScrollBar(); vbar->setValue(vbar->maximum()); } 

परिणाम

परिणाम एक मजेदार, सुंदर और आरामदायक कंसोल है। यह मुझे केवल 120 लाइनों का कोड लगा। बेशक, कई और चीजें हैं जो की जा सकती हैं, लेकिन बुनियादी कार्यक्षमता को लागू किया जाता है।

संदर्भ

GitHub पर RedisConsole परियोजना के लिए स्रोत कोड: https://github.com/ptrofimov/RedisConsole

वहां आप कंसोल विजेट क्लास को देख सकते हैं और "डाउनलोड" बटन पर क्लिक करके विंडोज के लिए संकलित एप्लिकेशन बाइनरी डाउनलोड कर सकते हैं।

आपका धन्यवाद