🎋 🐕 🕓 गुण Qt के लिए रूपरेखा 🎬 🏸 🧔🏼

समस्या

Qt में, एक अद्भुत चीज है - Q_PROPERTY, जो आपको किसी भी QObject क्लास में आवश्यक संपत्ति जोड़ने की अनुमति देता है। लेकिन कुछ मामलों में उनका उपयोग करना असुविधाजनक है।

उदाहरण के लिए, आपके पास एक एप्लिकेशन है जिसमें कई अलग-अलग ऑब्जेक्ट हैं (या आप बना सकते हैं) और आपको कॉन्फ़िगर करने की आवश्यकता है (चयनित ऑब्जेक्ट के गुणों के साथ एक संवाद प्रदर्शित करें)। इस तरह के अनुप्रयोगों का एक उदाहरण लगभग किसी भी इंजीनियरिंग कार्यक्रम, एक वेक्टर ग्राफिक्स संपादक, अंत में विजुअल स्टूडियो हो सकता है।

तो, कई ऑब्जेक्ट हैं जो उपयोगकर्ता "कॉन्फ़िगर" कर सकता है। इसके लिए किसी प्रकार का सार्वभौमिक तंत्र होना तर्कसंगत है, क्योंकि अन्यथा आपको प्रत्येक वस्तु के लिए अपनी स्वयं की सेटिंग्स संवाद को लागू करना होगा। Q_PROPERTY इसके लिए पूरी तरह उपयुक्त नहीं है। सबसे पहले, Q_PROPERTY के संपादन के लिए कोई मानक विजेट नहीं है। दूसरे, यहां तक कि अगर आप इन उद्देश्यों के लिए एक तृतीय-पक्ष विजेट का उपयोग करते हैं, तो आपके गुणों के साथ, मानक वाले (कम से कम ऑब्जेक्टनाम) प्रदर्शित किए जाएंगे। इसके अलावा, Q_PROPERTY पदानुक्रमों का समर्थन नहीं करता है (कभी-कभी यह समूह से संबंधित गुणों के लिए उपयोगी होता है); कोई विवरण नहीं (पाठ स्ट्रिंग इस संपत्ति की व्याख्या); GUI में Q_PROPERTY की उपस्थिति को अनुकूलित करने के लिए कोई उपाय नहीं है (प्रयोज्य में सुधार के लिए)।

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

निर्णय

सुविधाजनक गुण बनाने की कोशिश कर, मैंने एक QtnProperty प्रोजेक्ट बनाया। आगे मैं आपको बताऊंगा कि इस परियोजना के लिए क्या अच्छा है और इस पुस्तकालय का उपयोग कैसे करें।
सबसे पहले, पुस्तकालय में कई भाग होते हैं:

QtnPropertyCore - गैर-जीयूआई संबंधित कक्षाओं के साथ पुस्तकालय
QtnPropertyWidget - सम्पत्तियों के संपादन के लिए विजेट, साथ ही उपस्थिति को अनुकूलित करने और विभिन्न गुणों के संपादन के लिए प्रतिनिधि
QtnPEG एक एप्लिकेशन (एक मॉक जनरेटर के समान) है जो एक। ++ फ़ाइल से प्रॉपर्टीसेट का C ++ वर्ग बनाता है (यह गुणों का वर्णन करने का एक आसान तरीका है, वाक्यविन्यास QML के समान है)
QtnPropertyTests - QtnPropertyCore लाइब्रेरी के लिए परीक्षण
QtnPropertyDemo एक डेमो एप्लिकेशन है जहां आप QtnPropertyWidget का उपयोग करके संपत्तियों को संपादित कर सकते हैं, साथ ही एक स्क्रिप्ट से और स्ट्रिंग्स के रूप में पाठ सेट कर सकते हैं "SuperProperty.SubProperty =" मान

QtnPropertyCore

सबसे पहले, पुस्तकालय दो मुख्य वर्गों QtnProperty और QtnPropertySet को परिभाषित करता है। पहला सभी प्रकार के गुणों के लिए बुनियादी है (उदाहरण के लिए, QtnPropertyBool या QtnPropertyFloat ), और दूसरा गुणों के एक समूह का प्रतिनिधित्व करता है। QtnProperty और QtnPropertySet दोनों में एक आम अभिभावक है, QtnPropertyBase , जो बदले में, QObject का वंशज है। QtnPropertyBase क्लास में, QtnProperty और QtnPropertySet के बीच जो कुछ सामान्य है वह परिभाषित है :

QString नाम - संपत्ति या संपत्ति का नाम (ऑब्जेक्टनाम के समान)
QString विवरण - एक पाठ विवरण जिसे QtnPropertyWidget के निचले पैनल में प्रदर्शित किया जा सकता है
qint32 आईडी - समूह में अन्य लोगों के बीच अद्वितीय संपत्ति आईडी (बाइनरी फॉर्म में बचत करते समय उपयोग की जाती है)
QtnPropertyState स्थिति - संपत्ति की स्थिति (उदा। QtnPropertyStateImmutable - गैर-संपादन योग्य संपत्ति या QtnPropertyStateInv अदृश्य - अदृश्य)
लोड / सहेजें - QDataStream के माध्यम से सहेजें / लोड करें
fromStr / toStr - से संपत्ति मूल्य को / QString में बदलें
fromVariant / toVariant - गुण मान को / से QVariant में कनवर्ट करें
propertyWillChange - एक संकेत जो एक संपत्ति परिवर्तन से पहले शुरू हो जाता है (जब न केवल मूल्य बदल रहा है, बल्कि अन्य विशेषताएँ भी हैं - नाम, विवरण, आईडी, राज्य, आदि)
PropertyDidChange - एक संकेत जो एक संपत्ति परिवर्तन के बाद चालू हो जाता है (संपत्ति के लिए सममित है)

QtnPropertySet वर्ग में उनके साथ काम करने के लिए बच्चे के गुणों और तरीकों की एक सूची शामिल है। प्रत्येक प्रकार की संपत्ति के लिए (उदाहरण के लिए, एक पूर्णांक), दो वर्ग ( QtnPropertyInt और QtnPropertyIntCallback ) हैं। पहला वर्ग में मूल्य को संग्रहीत करता है, और दूसरा मूल्य प्राप्त करने या संग्रहीत करने के लिए कुछ फ़ंक्शन को कॉल करता है।
यहां उन गुणों की सूची दी गई है जो सीधे QtnPropertyCore मॉड्यूल में लागू की गई हैं:

QtnPropertyBool - एक बूलियन मान का प्रतिनिधित्व करता है।
QtnPropertyInt - एक हस्ताक्षरित पूर्णांक मान का प्रतिनिधित्व करता है।
QtnPropertyUInt - एक अहस्ताक्षरित पूर्णांक मान का प्रतिनिधित्व करता है।
QtnPropertyFloat - एक फ्लोटिंग-पॉइंट वास्तविक मूल्य का प्रतिनिधित्व करता है।
QtnPropertyDouble - एक वास्तविक डबल सटीक मूल्य का प्रतिनिधित्व करता है।
QtnPropertyEnum - किसी एन्यूमरेशन से मान का प्रतिनिधित्व करता है।
QtnPropertyEnumFlags - गणन से मूल्यों के संयोजन का प्रतिनिधित्व करता है।
QtnPropertyQString - एक स्ट्रिंग मान का प्रतिनिधित्व करता है।
QtnPropertyQPoint - QPoint मान का प्रतिनिधित्व करता है।
QtnPropertyQSize - QSize मान का प्रतिनिधित्व करता है।
QtnPropertyQRect - QRect मान का प्रतिनिधित्व करता है।
QtnPropertyQFont - QFont मान का प्रतिनिधित्व करता है।
QtnPropertyQColor - QColor मूल्य का प्रतिनिधित्व करता है।

सभी संख्यात्मक गुण ( QtnPropertyInt , QtnPropertyUInt , QtnPropertyFloat , QtnPropertyDouble ) के तीन अतिरिक्त तरीके हैं:

मिनवैल्यू न्यूनतम अनुमत मूल्य है।
maxValue अधिकतम अनुमत मूल्य है।
stepValue - मान बदलने के लिए कदम।

QtnPropertyWidget

इस मॉड्यूल में दो विजेट और प्रॉपर्टी डेलीगेट्स शामिल हैं।
QtnPropertyView वर्ग गुणों के एक सेट के लिए एक पेड़ विजेट लागू करता है।
QtnPropertyWidget क्लास समग्र है और इसमें QtnPropertyView और QLabel के निचले पैनल के रूप में शामिल है।

किसी विशेष संपत्ति की उपस्थिति या व्यवहार को बदलने के लिए, प्रतिनिधियों को पेश किया गया था। उदाहरण के लिए, QtnPropertyBool के लिए दो प्रतिनिधि हैं: QtnPropertyDelegateBoolCheck और QtnPropertyDelegateBoolCombobox । पहला एक चेकबॉक्स प्रदर्शित करता है, और दूसरा दो कस्टम मूल्यों (सच्चे और झूठे) के साथ एक कॉम्बोक्स प्रदर्शित करता है। आप अपने स्वयं के प्रतिनिधि बना सकते हैं और उन्हें डिफ़ॉल्ट के रूप में सेट कर सकते हैं, फिर नए प्रतिनिधि का उपयोग करके इस प्रकार के सभी गुण प्रदर्शित किए जाएंगे। कभी-कभी एक नए संपत्ति प्रकार की तुलना में एक नया प्रतिनिधि प्रकार बनाने के लिए यह आसान और अधिक सुविधाजनक होता है। उदाहरण के लिए, फ़ाइल पथ को संग्रहीत करने के लिए गुण QtnPropertyDelegateQStringFile प्रतिनिधि के माध्यम से QtnPropertyQString के लिए कार्यान्वित किया जाता है ।

कैसे उपयोग करें

उदाहरण के लिए, एक पाठ संपादक के लिए गुणों का एक छोटा सेट पर विचार करें।
यह वह है जो हम उपयोगकर्ता को दिखाना चाहते हैं।

और यहाँ है कि प्रोग्रामर को ऐसी प्रॉपर्टी सेट प्राप्त करने के लिए क्या करना चाहिए:

QtnPropertySet* textProperties = new QtnPropertySet(owner); QtnPropertyBool* enableWrapping = new QtnPropertyBool(textProperties); enableWrapping->setName(tr("enableWrapping")); enableWrapping->setDescription(tr("Enable/disable text wrapping")); enableWrapping->setValue(true); QtnPropertyQColor* textColor = new QtnPropertyQColor(textProperties); textColor->setName(tr("textColor")); textColor->setDescription(tr("Foreground text color")); textColor->setValue(QColor(0, 0, 0)); QtnPropertySet* Tabulation = new QtnPropertySet(textProperties) Tabulation->setName(tr("Tabulation")); Tabulation->setDescription(tr("Tabulation settings")); QtnPropertyBool* replaceWithSpaces = new QtnPropertyBool(Tabulation); replaceWithSpaces->setName(tr("replaceWithSpaces"); replaceWithSpaces->setDescription(tr("Automatically replace tabs with spaces")); replaceWithSpaces->setValue(false); QtnPropertyUInt* tabSize = new QtnPropertyUInt(Tabulation); tabSize->setName(tr("tabSize")); tabSize->setDescription(tr("Number of spaces to be placed.")); tabSize->setState(QtnPropertyStateImmutable); tabSize->setValue(4); tabSize->setMinValue(1); tabSize->setMaxValue(10); //    propertyDidChange auto lambda = [tabSize, replaceWithSpaces](const QtnPropertyBase* changedProperty, const QtnPropertyBase* firedProperty, QtnPropertyChangeReason reason) { //    if (reason & QtnPropertyChangeReasonValue) { if (*replaceWithSpaces) //  tabSize  tabSize->removeState(QtnPropertyStateImmutable); else //  tabSize   tabSize->addState(QtnPropertyStateImmutable); }; QObject::connect(replaceWithSpaces, &QtnProperty::propertyDidChange, lambda); //       replaceWithSpaces ...

प्रोग्रामर के लिए जीवन को आसान बनाने के लिए (या गैर-प्रोग्रामर को संपत्तियों का वर्णन करने का अवसर भी दें), एक छोटा क्यूटीएनपीईजी कोड जनरेटर विकसित किया गया था।
यहाँ Text.pef फ़ाइल में हमारे उदाहरण का वर्णन है:

 property_set Text { Bool enableWrapping { description = "Enable/disable text wrapping"; value = true; } QColor textColor { description = "Foreground text color"; value = QColor(0, 0, 0); } property_set Tabs Tabulation { description = "Tabulation settings"; Bool replaceWithSpaces { description = "Automatically replace tabs with spaces"; value = false; //    delegate ComboBox { //     true labelTrue = "On"; //     false labelFalse = "Off"; } //      replaceWithSpaces.propertyDidChange slot propertyDidChange { tabSize.switchState(QtnPropertyStateImmutable, !replaceWithSpaces); } } UInt tabSize { description = "Number of spaces to be placed."; state = QtnPropertyStateImmutable; value = 4; } } }

सरल और संक्षिप्त पर्याप्त। QtnPEG दो फाइलें बनाता है: Text.peg.h और Text.peg.cpp, जहां दो कक्षाएं स्थित हैं। QtnPropertySetText और QtnPropertySetTabs QtnPropertySet से निकली कक्षाएं हैं।
उत्पन्न वर्गों में, आप निम्न उप-संपत्ति घोषणा देख सकते हैं, उदाहरण के लिए QtnPropertySetText :

  // start children declarations QtnPropertyBool& enableWrapping; QtnPropertyQColor& textColor; QtnPropertySetTabs& Tabulation; // end children declarations

इस प्रकार, C ++ कोड में एक प्रोग्रामर इस वर्ग के साथ खेतों की संरचना के रूप में काम कर सकता है। उदाहरण के लिए:

 void doSomething(const QtnPropertySetText& textParams, QString& text) { if (textParams.Tabulation.replaceWithSpaces) { QString spaces(QChar::Space, textParams.Tabulation.tabSize); text.replace(QChar::Tabulation, spaces); } }

परिणाम

मुझे उम्मीद है कि मैं अपने प्रोजेक्ट का कुछ विचार देने में सक्षम था।
मुझे खुशी होगी अगर यह किसी के लिए उपयोगी है, खासकर जहां कई सेटिंग्स हैं और हर चीज के लिए एक जीयूआई विकसित करना और सब कुछ अनावश्यक है। यदि, आपकी राय में, QtnProperty के पूर्ण उपयोग के लिए पर्याप्त कार्यक्षमता नहीं है, तो कृपया टिप्पणी करें।