WxStyledTextCtrl पर आधारित सिंटैक्स हाइलाइटिंग के साथ एक क्रॉस-प्लेटफ़ॉर्म संपादक का विकास

दिन का अच्छा समय

मैं आपको सिंटैक्स हाइलाइटिंग या एक कोड संपादक के साथ एक संपादक को विकसित करने में अपने अनुभव के बारे में बताना चाहता हूं। यह एक कस्टम भाषा के लिए एक संपादक है। इस पोस्ट का सार विकास प्रक्रिया का विस्तृत विवरण नहीं है - मैं केवल सबसे दिलचस्प बिंदुओं पर ध्यान केंद्रित करूँगा, खराब रूप से संरक्षित या यहां तक ​​कि प्रलेखन में छोड़े गए।

सिंटिला कोड एडिटर बनाने के लिए सबसे प्रसिद्ध मुफ्त घटकों में से एक है, wxWidgets में अपने रैपर wxStyledTextCtrl ।
सिंटिला अधिकतर उपयोग की जाने वाली प्रोग्रामिंग भाषाओं का समर्थन करता है, इसलिए एक नया शब्द जोड़ने वाला अक्सर निकटतम भाषा के साथ सादृश्य द्वारा किया जाता है। इस प्रक्रिया को यहां और अधिक विस्तार से वर्णित किया गया है । यह विधि लागू करने के लिए बहुत सरल है, लेकिन इसमें एक महत्वपूर्ण कमी है - आपको अपनी परियोजना में सभी स्किनटिला कोड को शामिल करना होगा। छोटी और अपेक्षाकृत स्थिर परियोजनाओं के लिए यह बहुत महत्वपूर्ण नहीं है, लेकिन भारी और सक्रिय रूप से विकसित परियोजनाओं के लिए यह बहुत सारी समस्याओं का कारण बनता है। समर्थन और भी मुश्किल है अगर आप सिंटिला घटक का उपयोग नहीं करते हैं, लेकिन इसके आवरण, उदाहरण के लिए, wxStyledTextCtrl । एक विकल्प कंटेनर में लीकर के तथाकथित कार्यान्वयन है ।

Scintilla में लेक्सर एकीकरण

सबसे पहले, एक सरल विधि के बारे में कुछ शब्द। सामान्य तौर पर, अपने स्वयं के लेक्सर को बनाने के लिए, आपको केवल एक फ़ंक्शन लिखना होगा जो कोड के परिवर्तित भाग को रंगने के लिए जिम्मेदार होगा:
static void ColouriseDoc (unsigned int startPos, int length, int initStyle, WordList *keywordlists[], Accessor &styler) । एक निर्दिष्ट सीमा को चित्रित या स्टाइल करने के लिए प्रत्येक वर्ण के लिए एक शैली निर्दिष्ट करने का मतलब है। उसी समय, घटक इसके लायक नहीं है यह पाठ रेंडरिंग को अनुकूलित करता है, और यह भी गारंटी देता है कि रेंज [startPos, startPos + length - 1] एक पूर्णांक संख्या रेखाएं हैं, जो पार्सर के कार्यान्वयन की सुविधा प्रदान करती हैं।

एक कंटेनर में एक लेक्सर लागू करें

मैंने एक वर्ग बनाकर शुरुआत की थी - उदाहरण में संकेत के रूप में wxStyledTextCtrl का एक वंशज। पिछली पद्धति की तरह, लेक्सर को केवल एक फ़ंक्शन की आवश्यकता होती है, जो इस मामले में EVT_STC_STYLENEEDED ईवेंट पर कहा जाएगा।
अनुभव से पता चला है कि यदि संपादित फ़ाइलों का आकार 50-60 लाइनों से अधिक नहीं है, तो आप सुरक्षित रूप से ईवेंट द्वारा प्रेषित सीमा को अनदेखा कर सकते हैं और फ़ाइल की संपूर्ण सामग्री को स्टाइल कर सकते हैं, जो कि लेक्सर को सरल करता है। यदि लाइनों की संख्या अधिक है, तो स्टाइल को GetEndStyled() , बल्कि पिछली पंक्ति से अद्यतन करना बेहतर है। पिछली विधि की तरह, घटना को पूर्णांक संख्या में पंक्तियों के लिए उठाया जाता है।

वे मैनुअल में उल्लेख करना भूल गए

इस अवस्था में मुझे पहले से ही जो मुश्किलें थीं उनमें से एक यह है कि यह घटना बहुत बार शुरू हो जाती है। डीबगर में घटक के व्यवहार के एक छोटे से अध्ययन से पता चला है कि रेंज [एन, एम] को स्टाइल करने के बाद, अंतिम स्टाइल किया गया प्रतीक बिल्कुल नहीं है। सबसे अधिक बार, यह पिछले प्रतीक था, कभी-कभी प्रतीक 2-3 वर्णों से अलग होता है। कई कारण थे:

• सभी कस्टम शैलियों में 0 से अधिक सूचकांक होने चाहिए,
• रिक्त स्थान और लाइन ब्रेक सहित पूरी तरह से सब कुछ स्टाइल करने की आवश्यकता है
• शैलियों को क्रमिक रूप से लागू किया जाना चाहिए, अर्थात्। यदि आप पहली बार स्टाइल को रेंज [0, 100] पर लागू करते हैं, और फिर [0, 10] तक - अंतिम शैली 10 वीं है, 100 वीं नहीं

मैंने एक लाइन-बाय-लाइन पार्सर लागू किया और अनावश्यक ईवेंट कॉल से बचने के लिए, मुझे अंतिम शैली वाले चरित्र के सूचकांक को संग्रहीत करना पड़ा।

SetStyleBytes के माध्यम से सेट करें

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

रूसी पत्र

शैलियों के लिए रूसी अक्षरों के साथ शब्दों को सही ढंग से स्वीकार करने के लिए, आपको क्रमिक रूप से प्रदर्शन pos = PositionAfter(pos) द्वारा क्रमिक रूप से अंतिम वर्ण के सूचकांक की सही गणना करने की आवश्यकता है। स्थिति की गणना करने का एक समान तरीका स्वचालित प्रतिस्थापन pos = PositionBefore(pos) कॉल करते समय शब्द का हिस्सा प्राप्त करने के लिए लागू किया जाना चाहिए।

कोड का एक टुकड़ा छिपाना (तह)

इस फ़ंक्शन के कार्यान्वयन से कोई विशेष समस्या नहीं हुई, और प्रलेखन में कोई अंतराल नहीं थे। मेरा कहना है कि तह SetFoldLevel(...) लाइन के स्तर पर आधारित है, उदाहरण के लिए, मैंने सीधे SetFoldLevel(...) में रखा है (यही वजह है कि लाइन-बाय-लाइन पार्सर अधिक सुविधाजनक है)।

स्वतः पूर्ण कार्य

यद्यपि फ़ंक्शन प्रलेखन में अपेक्षाकृत विस्तृत है, कुछ चीजें गायब हैं। सबसे पहले, यह पता चला कि AutoCompShow(...) घटक AutoCompShow(...) का मानक कार्य शब्द के दर्ज किए गए भाग से फ़िल्टर नहीं होता है, लेकिन केवल स्थिति है। तब AutoCompSelect() फ़ंक्शन, जिसे उपयोगकर्ता द्वारा चुने गए शब्द को प्रतिस्थापित करना चाहिए, बेकार हो गया, क्योंकि यह अक्सर बिना किसी स्पष्ट कारण के अपवाद का कारण बनता था। इसके बजाय, झंडा AutoCompSetChooseSingle () सेट करना बेहतर है।

कॉल टिप्स

wxStyledTextCtrl का एक और कोई कम सुविधाजनक कार्य CallTipShow () कॉल संकेत प्रदर्शित नहीं कर रहा है। इसके साथ काम करना AutoCompShow() लुकअप फ़ंक्शन के साथ काम करने के समान है। यह ध्यान दिया जाना चाहिए कि वे एक साथ गुजरते हैं।

उपरोक्त विशेषताओं को देखते हुए, wxStyledTextCtrl कंटेनर में एक काफी जटिल wxStyledTextCtrl लागू करने की अनुमति देता है।