👩🏻‍💼 👦🏻 🤐 KOMPAS-3D API → पाठ 11 → सरल पाठ लेबल के साथ कार्य करें 👍 🙍🏻 🍯

चक्र के पिछले पाठों में, हमने शीर्षक ब्लॉक में पाठ प्रदर्शित करना सीखा। आज हम इस बात पर चर्चा करेंगे कि पाठ को दस्तावेज़ में कैसे आउटपुट किया जाए। हम सबसे सरल उदाहरणों पर विचार करेंगे, और निम्नलिखित पाठों में अधिक जटिल चाल दिखाएंगे।

सबक श्रृंखला की सामग्री "KOMPAS-3D API के साथ कार्य करना"

मूल बातें
ड्राइंग डिजाइन
KOMPAS से सही संबंध
मुख्य शिलालेख
ग्राफिक आदिम
विभिन्न स्वरूपों में एक दस्तावेज़ सहेजना
सेटिंग्स जानने के लिए
शीर्षक ब्लॉक में अधिक परिष्कृत लेखन विधियाँ
कैप्शन कोशिकाओं को पढ़ना
एक स्ट्रिंग सहित विशेष वर्ण
सरल पाठ लेबल

पाठ लंगर बिंदु

कोमपा में पाठ को हमेशा किसी बिंदु के सापेक्ष प्रदर्शित किया जाता है, जिसे लंगर बिंदु कहा जाता है। पाठ को इसके सापेक्ष अलग-अलग स्थित किया जा सकता है। एंकर बिंदु के सापेक्ष पाठ के स्थान का पता लगाने के लिए, ksDocument2D इंटरफ़ेस के ksGetTextAlign विधि का उपयोग किया जाता है । निम्नलिखित इसका प्रोटोटाइप है।

long ksGetTextAlign ( long pText //   );

एकमात्र पैरामीटर के रूप में, यह एक पूर्णांक सूचक को एक पाठ ऑब्जेक्ट पर ले जाता है। विधि बाध्यकारी के प्रकार , या त्रुटि के मामले में -1 लौटाती है। मान्य बाध्यकारी प्रकार नीचे दी गई तालिका में दिखाए गए हैं।

वैध बाध्यकारी प्रकारों की तालिका

पाठ बाइंडिंग को बदलने के लिए, ksDocument2D इंटरफ़ेस के ksSetTextAlign विधि का उपयोग करें। निम्नलिखित इसका प्रोटोटाइप है।

 long ksSetTextAlign ( long pText, //   «» long align //  );

यदि सफल होता है, तो यह विधि 1 देता है, और त्रुटि के मामले में, शून्य देता है ।

पाठ आउटपुट

सरल पाठ आउटपुट के लिए, ksDocument2D इंटरफ़ेस के ksText विधि का उपयोग करें। निम्नलिखित इस विधि का एक प्रोटोटाइप है।

 long ksText ( double x, //   double y, double ang, //   double hStr, //    double ksuStr, //  long bitVector, //  BSTR s //  );

आइए ksText विधि के मापदंडों का विश्लेषण करें । हमने पिछले भाग में लंगर बिंदु पर चर्चा की।

कोण पैरामीटर टेक्स्ट की एक रेखा और एक क्षैतिज रेखा के बीच के कोण को डिग्री में सेट करता है। कोण को वामावर्त गिना जाता है। नीचे दी गई छवि 45 ° के कोण पर खींची गई रेखा दर्शाती है।

45 ° स्ट्रिंग

HStr पैरामीटर मिलीमीटर में स्ट्रिंग वर्णों के आकार को निर्धारित करता है। यदि इस पैरामीटर का मान शून्य है , तो डिफ़ॉल्ट आकार का उपयोग किया जाता है।

KsuStr पैरामीटर पाठ के स्ट्रेचिंग (संकुचित) को निर्दिष्ट करता है। नीचे दिया गया आंकड़ा ksuStr पैरामीटर के विभिन्न मूल्यों के साथ कई लाइनें दिखाता है।

विभिन्न खिंचाव मूल्यों के साथ कई लाइनें

इस आंकड़े से यह देखा जा सकता है कि "स्ट्रेचिंग 0" "स्ट्रेचिंग 1" के बराबर है, यानी किसी स्ट्रेचिंग का अभाव।

बिटवेक्टर पैरामीटर में झंडे का एक सेट होता है जो वर्ण शैली निर्धारित करता है। मान्य झंडे नीचे दी गई तालिका में सूचीबद्ध हैं।

चरित्र झंडे टेबल

वास्तव में, अन्य वैध झंडे हैं, लेकिन उनका काम केवल जटिल मिश्रित तारों के निर्माण में दिखाई देता है। हम अगले पाठ में उनमें से कुछ पर विचार करेंगे।
याद रखें - आउटपुट स्ट्रिंग में वर्ण @ , $ , & , ~ , ^ और # शामिल नहीं होने चाहिए, क्योंकि वे नियंत्रण वर्ण हैं। हम अपने चक्र के अगले पाठों में उनके साथ काम करने के बारे में बात करेंगे।
सफल होने पर, ksText विधि पाठ को पूर्णांक सूचक लौटाती है। यह पॉइंटर पारित किया जा सकता है, उदाहरण के लिए, लंगर बिंदु के सापेक्ष पाठ की स्थिति को बदलने के लिए ksSetTextAlign विधि। किसी त्रुटि के मामले में, ksText विधि शून्य हो जाती है ।

उदाहरण

निम्नलिखित एक उदाहरण कार्यक्रम है जो ksText विधि का उपयोग करके स्ट्रिंग आउटपुट प्रदर्शित करता है।

 //  BSTR str = SysAllocString(L""); long itext; itext = Document2D->ksText(100, 100, //  0, //  11, //  0, // 0, //  str); SysFreeString(str); //    Document2D->ksSetTextAlign(itext, txta_Left); Document2D.Unbind(); //   kompas->Visible = true; kompas.Unbind();

सादगी के लिए, दस्तावेज़ के निर्माण और निष्पादन के लिए जिम्मेदार कोड इस उदाहरण में छोड़ा गया है। इस कार्यक्रम के परिणामस्वरूप, दस्तावेज़ में "स्ट्रिंग" पाठ प्रदर्शित होता है।

पाठ का आकार

किसी दस्तावेज़ में पाठ प्रदर्शित करते समय, यह जानना उपयोगी होता है कि इसमें कितना स्थान है। पाठ की ऊंचाई ksText विधि के hStr पैरामीटर द्वारा निर्धारित की जाती है। लेकिन इसकी लंबाई सीधे आउटपुट स्ट्रिंग पर निर्भर करती है।

इसे निर्धारित करने के लिए, ksDocument2D इंटरफ़ेस के ksGetTextLengthFromReference विधि का उपयोग करें। इस विधि में केवल एक पैरामीटर है - पाठ के लिए एक पूर्णांक सूचक। यह पाठ की लंबाई को मिलीमीटर में लौटाता है।

KsGetTextLengthFromReference विधि इस बात में असुविधाजनक है कि यह दस्तावेज़ को आउटपुट करने से पहले आपको लाइन की लंबाई निर्धारित करने की अनुमति नहीं देता है। एक स्ट्रिंग की लंबाई निर्धारित करने के लिए जो अभी तक दस्तावेज़ में आउटपुट नहीं हुई है, आपको ksGetTextLength विधि का उपयोग करने की आवश्यकता है। लेकिन इस पर विचार करने से पहले, शैलियों के बारे में बात करते हैं।

पाठ शैली

कोम्पस प्रणाली दस्तावेजों में प्रदर्शित ग्रंथों के लिए कई शैलियों को पूर्वनिर्धारित करती है। प्रत्येक शैली में एक पूर्णांक होता है। सबसे अधिक इस्तेमाल की जाने वाली शैलियाँ नीचे दी गई तालिका में हैं।

आमतौर पर प्रयुक्त टेक्स्ट शैलियाँ

इस तालिका में सभी शैलियों को नहीं दिया गया है: उनमें से केवल एक हिस्सा। उपलब्ध स्थिरांक की एक पूरी सूची कोमपस दस्तावेज में "पैरामीटर संरचना और स्थिरांक \ कॉन्स्टेंट \ पाठ कॉन्स्टेंट \ सिस्टम टेक्स्ट शैलियाँ" पृष्ठ पर देखी जा सकती है।

KsGetTextLength विधि

KsDocument2D इंटरफ़ेस का ksGetTextLength विधि आपको दस्तावेज़ के आउटपुट से पहले एक स्ट्रिंग की लंबाई निर्धारित करने की अनुमति देती है। नीचे इस पद्धति का एक प्रोटोटाइप है।

 double ksGetTextLength ( BSTR text, // long style //  );

विधि स्ट्रिंग की लंबाई मिलीमीटर में लौटाती है। कृपया ध्यान दें: विधि स्ट्रिंग को एक पैरामीटर के रूप में स्वीकार करती है, न कि "टेक्स्ट" ऑब्जेक्ट के लिए एक संकेतक। यह आपको दस्तावेज़ के आउटपुट से पहले लाइन के आकार का मूल्यांकन करने की अनुमति देता है।

उदाहरण

KsGetTextLength विधि का उपयोग करने के एक उदाहरण पर विचार करें। मान लें कि हमारे पास एक पंक्ति है और हमें इसे एक निश्चित लंबाई की आयत में रखने की आवश्यकता है (यह कार्य पैराग्राफ की मदद से हल करना बहुत आसान है, लेकिन अगले पाठों में उनके बारे में)। यदि रेखा इसमें फिट होती है, तो यह पूर्ण रूप से प्रदर्शित होती है। यदि नहीं, तो इसे काट दिया जाता है और इसके अंत में एक दीर्घवृत्त रखा जाता है। नीचे प्रोग्राम का सोर्स कोड है जो इस तरह की समस्या को हल करता है।

 const wchar_t FULLSTR[] = L"  !   !   !"; const wchar_t DOTS[] = L"..."; const long STYLE = 1; double maxSize = 100.0; BSTR str = SysAllocString(FULLSTR); if(Document2D->ksGetTextLength(str, STYLE) > maxSize) { //   BSTR str_dots = SysAllocString(DOTS); double size_dots = Document2D->ksGetTextLength(str_dots, STYLE); SysFreeString(str_dots); //     maxSize -= size_dots; SysReAllocStringLen(&str, str, SysStringLen(str) - 4); // ,     while(Document2D->ksGetTextLength(str, STYLE) > maxSize) SysReAllocStringLen(&str, str, SysStringLen(str) - 1); //    size_t len = SysStringLen(str); SysFreeString(str); //     wchar_t *p = new wchar_t[len + wcslen(DOTS) + 1]; wcsncpy(p, FULLSTR, len); p[len] = L'\0'; wcscat(p, DOTS); str = SysAllocString(p); delete [] p; } //    Document2D->ksText(100, 100, //  0, //  0, //  0, // 0, //  str); //  SysFreeString(str); Document2D.Unbind(); //   kompas->Visible = true; kompas.Unbind();

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

एक बहुत ही महत्वपूर्ण बिंदु पर ध्यान दें: एक स्ट्रिंग को आउटपुट करते समय, ksText विधि के सभी मापदंडों (एंकर बिंदु के निर्देशांक को छोड़कर) का एक शून्य मूल्य होता है । तथ्य यह है कि ksGetTextLength विधि इन मापदंडों के बारे में कुछ नहीं जानती है, इसलिए यह स्ट्रिंग की लंबाई की गणना करते समय उन्हें ध्यान में नहीं रख सकता है। इस प्रकार, यदि एक स्ट्रिंग का आउटपुट ksText विधि के मापदंडों के गैर-शून्य मानों का उपयोग करता है, तो परिणामी स्ट्रिंग लंबाई ksGetTextLength विधि द्वारा प्राप्त किए गए से भिन्न हो सकती है।

निष्कर्ष

इस पाठ में, हमने सीखा कि कैसे ksText विधि का उपयोग करके सरल पाठ लेबल प्रदर्शित करें। यह पाठ प्रदर्शित करने का एकमात्र तरीका नहीं है, लेकिन शायद सबसे आसान है। अगले पाठ में, हम देखेंगे कि इस पद्धति का उपयोग करके यह यौगिक रेखा कैसे आउटपुट हो सकती है। और निम्नलिखित में, हम अधिक जटिल पाठ आउटपुट विधियों पर विचार करेंगे।

जारी रखने के लिए, ब्लॉग की खबरों का पालन करें।

सर्गेई नोरसेव, पीएचडी, "डेल्फी में कम्पास के लिए अनुप्रयोग विकास" पुस्तक के लेखक।

KOMPAS-3D API → पाठ 11 → सरल पाठ लेबल के साथ कार्य करें

सबक श्रृंखला की सामग्री "KOMPAS-3D API के साथ कार्य करना"

पाठ लंगर बिंदु

पाठ आउटपुट

उदाहरण

पाठ का आकार

पाठ शैली

KsGetTextLength विधि

उदाहरण

More articles: