KOMPAS-3D API → पाठ 10 → एक स्ट्रिंग सहित विशेष वर्णों के साथ कार्य करें

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

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

1. मूल बातें
2. ड्राइंग डिजाइन
3. KOMPAS से सही संबंध
4. मुख्य शिलालेख
5. ग्राफिक आदिम
6. विभिन्न स्वरूपों में एक दस्तावेज़ सहेजना
7. सेटिंग्स जानने के लिए
8. शीर्षक ब्लॉक में अधिक परिष्कृत लेखन विधियाँ
9. कैप्शन कोशिकाओं को पढ़ना
10. एक स्ट्रिंग सहित विशेष वर्ण

एक स्ट्रिंग सहित विशेष वर्ण

विशेष चिन्हों की तालिका कोम्पस की मुख्य मदद के परिशिष्ट V में है

78-80 , 83 , 93-99 , 171 और 172 संख्याओं वाले विशेष वर्णों में स्ट्रिंग शामिल हैं। इस स्थिति में, ksTextItemParam इंटरफ़ेस का स्ट्रिंग s विशेष वर्ण के बाद स्थित नहीं है, लेकिन इसके अंदर है। उदाहरण के लिए, संख्या 80 के साथ एक विशेष चरित्र फ्रेम में पाठ प्रदर्शित करता है। निम्नलिखित एक कार्यक्रम का एक उदाहरण है जो इस तरह के एक विशेष चरित्र के साथ काम करता है।

//    TextItemParamPtr TextItemParam; TextItemParam=(TextItemParamPtr)kompas->GetParamStruct(ko_TextItemParam); //  TextItemParam->set_type(SPECIAL_SYMBOL); TextItemParam->set_iSNumb(98); BSTR str = SysAllocString(L""); TextItemParam->set_s(str); SysFreeString(str); //    StampPtr Stamp; Stamp=(StampPtr)Document2D->GetStamp(); //     Stamp->ksOpenStamp(); Stamp->ksColumnNumber(1); Stamp->ksTextLine(TextItemParam); //     Stamp->ksCloseStamp(); Stamp.Unbind(); TextItemParam.Unbind(); Document2D.Unbind(); //   kompas->Visible = true; kompas.Unbind(); 

सादगी के लिए, यह उदाहरण दस्तावेज़ के निर्माण और निष्पादन के लिए जिम्मेदार कोड को छोड़ देता है (यह विषय चक्र के पिछले पाठों में चर्चा की गई थी)। नीचे दिया गया आंकड़ा इस कार्यक्रम द्वारा गठित मुख्य लेबल दिखाता है।



सादगी के लिए, हम केवल एक सेल में भरते हैं। संख्या 98 के साथ विशेष चरित्र वर्गमूल के संकेत को परिभाषित करता है। ध्यान दें कि ksTextItemParam इंटरफ़ेस के s गुण का मान पूरी तरह से रूट साइन के अंतर्गत है। स्ट्रिंग सहित अन्य विशेष वर्ण, ठीक उसी तरह से काम करते हैं।

विशेष वर्ण और ksTextLineParam

विशेष वर्णों की कार्रवाई ksTextItemParam इंटरफ़ेस तक सीमित नहीं है। नीचे दिए गए उदाहरण पर विचार करें।

 //     TextItemParamPtr TextItemParam; TextItemParam=(TextItemParamPtr)kompas->GetParamStruct(ko_TextItemParam); //     DynamicArrayPtr DynamicArray; DynamicArray=(DynamicArrayPtr)kompas->GetDynamicArray(TEXT_ITEM_ARR); //   TextItemParam->set_type(SPECIAL_SYMBOL); TextItemParam->set_iSNumb(98); BSTR str = SysAllocString(L"1 "); TextItemParam->set_s(str); SysFreeString(str); DynamicArray->ksAddArrayItem(-1, TextItemParam); //   TextItemParam->Init(); TextItemParam->set_type(SPECIAL_SYMBOL); TextItemParam->set_iSNumb(169); str = SysAllocString(L"2 "); TextItemParam->set_s(str); SysFreeString(str); DynamicArray->ksAddArrayItem(-1, TextItemParam); //   TextItemParam->Init(); TextItemParam->set_type(0); str = SysAllocString(L" 3"); TextItemParam->set_s(str); SysFreeString(str); DynamicArray->ksAddArrayItem(-1, TextItemParam); //   ksTextLineParam TextLineParamPtr TextLineParam; TextLineParam=(TextLineParamPtr)kompas->GetParamStruct(ko_TextLineParam); TextLineParam->SetTextItemArr(DynamicArray); //    StampPtr Stamp; Stamp=(StampPtr)Document2D->GetStamp(); //     Stamp->ksOpenStamp(); Stamp->ksColumnNumber(1); Stamp->ksTextLine(TextLineParam); //     Stamp->ksCloseStamp(); Stamp.Unbind(); TextItemParam.Unbind(); TextLineParam.Unbind(); DynamicArray->ksDeleteArray(); DynamicArray.Unbind(); Document2D.Unbind(); //   kompas->Visible = true; kompas.Unbind(); 

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



कृपया ध्यान दें कि लाइन "पेज 2" और लाइन "पेज 3" को दूसरे विशेष चरित्र में शामिल किया गया था, जिसे हमने विशेष चरित्र के बाहर प्रदर्शित करने की योजना बनाई थी। इसके अलावा, इन दोनों पंक्तियों को पहले विशेष चरित्र में शामिल किया गया था (हमने इसकी योजना नहीं बनाई थी)। यह उदाहरण दो महत्वपूर्ण बिंदुओं को प्रदर्शित करता है:

• विशेष वर्णों में अन्य विशेष वर्ण शामिल हो सकते हैं;
• विशेष वर्ण की कार्रवाई ksTextLineParam इंटरफ़ेस बनाने वाले सभी घटकों तक फैली हुई है।

एक उचित सवाल उठता है - क्या विशेष चरित्र की कार्रवाई को सीमित करने का एक तरीका है? हाँ है। लेकिन इसे समझने के लिए, आपको पहले ksTextItemFont इंटरफ़ेस से परिचित होना होगा ।

पाठ घटक फ़ॉन्ट विकल्प ( ksTextItemFont )

प्रलेखन के अनुसार, ksTextItemFont इंटरफ़ेस पाठ घटक के फ़ॉन्ट मापदंडों का वर्णन करता है। लेकिन वास्तव में, इसकी क्षमताओं का उपयोग किए गए फ़ॉन्ट के सरल विवरण से अधिक है। यह इंटरफ़ेस आपको संयुक्त लाइनें बनाने की अनुमति देता है (उनके बारे में - चक्र के अगले पाठों में)।

आप इसे कई तरीकों से प्राप्त कर सकते हैं। सबसे पहले, KompasObject इंटरफ़ेस के GetParamStruct विधि का उपयोग करते हुए: इसके लिए, निरंतर ko_TextItemFont को केवल पैरामीटर के रूप में इस विधि में पारित किया जाना चाहिए। दूसरे, ksTextItemParam इंटरफ़ेस के GetItemFont विधि का उपयोग करना। इस विधि में कोई इनपुट पैरामीटर नहीं है और ksTextItemFont इंटरफ़ेस पाठ घटक के साथ पहले से जुड़ा हुआ है।

KsTextItemFont इंटरफ़ेस के गुणों पर विचार करें।
बिटवेक्टर - एक बिट वेक्टर जो पाठ की विशेषताओं को परिभाषित करता है (उन्हें चक्र के अगले पाठों में विस्तार से चर्चा की जाएगी)।
आरजीबी प्रारूप में वर्णों का रंग।
fontName - फ़ॉन्ट नाम के साथ एक स्ट्रिंग।
ऊँचाई - मिलीमीटर में फ़ॉन्ट ऊंचाई।
ksu पाठ खंड कारक है।
KsTextItemFont इंटरफ़ेस के लिए केवल तीन विधियाँ हैं।
Init () सभी इंटरफ़ेस गुणों को रीसेट करता है। इसका कोई इनपुट पैरामीटर नहीं है। यदि सफल, TRUE लौटाता है, और त्रुटि के मामले में - FALSE ।
GetBitVectorValue बिटवेक्टर सेट से एक व्यक्तिगत ध्वज का मूल्य लौटाता है। यह एकमात्र पैरामीटर के रूप में एक ध्वज लेता है, जिसका मूल्य हम निर्धारित करना चाहते हैं। यदि यह सेट है, तो विधि TRUE ; यदि रीसेट, FALSE है ।
SetBitVectorValue एकल ध्वज का मान बदलता है। इस पद्धति का एक प्रोटोटाइप निम्नलिखित है:

 BOOL SetBitVectorValue ( long bitVector, //  BOOL state //   ); 

यदि राज्य पैरामीटर मान TRUE है , तो बिटवेक्टर ध्वज को लाद दिया जाता है , अन्यथा इसे रीसेट कर दिया जाता है।
यदि सफल, SetBitVectorValue विधि TRUE लौटाती है, और त्रुटि के मामले में, FALSE ।
GetBitVectorValue और SetBitVectorValue तरीके आपको सीधे पहुँच के बिना बिटवेक्टर संपत्ति के साथ काम करने की अनुमति देते हैं।

विशेष वर्ण सीमा

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



जब हम इंटरफ़ेस ksTextItemParam का वर्णन करते हैं, तो फ्लैग SPECIAL_SYMBOL हम पहले ही विचार कर लेते हैं । यह इंगित करने के लिए आवश्यक है - एक विशेष चरित्र प्रदर्शित किया जाता है। उसी ध्वज को ksTextItemFont इंटरफ़ेस की बिटवेक्टर संपत्ति में डुप्लिकेट किया गया है (जैसा कि मेरे प्रयोगों से पता चलता है, यह दोहराव वैकल्पिक है)।

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

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

उदाहरण

नीचे संशोधित कार्यक्रम का स्रोत कोड है। ऊपर वर्णित झंडे का उपयोग करना, यह घटकों के सही उत्पादन को लागू करता है।

 //     TextItemParamPtr TextItemParam; TextItemParam=(TextItemParamPtr)kompas->GetParamStruct(ko_TextItemParam); //     DynamicArrayPtr DynamicArray; DynamicArray=(DynamicArrayPtr)kompas->GetDynamicArray(TEXT_ITEM_ARR); //   TextItemParam->set_type(SPECIAL_SYMBOL); TextItemParam->set_iSNumb(98); BSTR str = SysAllocString(L"1 "); TextItemParam->set_s(str); SysFreeString(str); DynamicArray->ksAddArrayItem(-1, TextItemParam); //   TextItemFontPtr TextItemFont; TextItemParam->Init(); TextItemFont=(TextItemFontPtr)TextItemParam->GetItemFont(); TextItemFont->set_bitVector(SPECIAL_SYMBOL_END); DynamicArray->ksAddArrayItem(-1, TextItemParam); TextItemFont->Init(); TextItemFont.Unbind(); //   TextItemParam->Init(); TextItemParam->set_type(SPECIAL_SYMBOL); TextItemParam->set_iSNumb(169); str = SysAllocString(L"2 "); TextItemParam->set_s(str); SysFreeString(str); DynamicArray->ksAddArrayItem(-1, TextItemParam); //      TextItemParam->Init(); TextItemFont=(TextItemFontPtr)TextItemParam->GetItemFont(); TextItemFont->set_bitVector(SPECIAL_SYMBOL_END); TextItemParam->set_type(0); str = SysAllocString(L"  3"); TextItemParam->set_s(str); SysFreeString(str); DynamicArray->ksAddArrayItem(-1, TextItemParam); TextItemFont.Unbind(); //   ksTextLineParam TextLineParamPtr TextLineParam; TextLineParam=(TextLineParamPtr)kompas->GetParamStruct(ko_TextLineParam); TextLineParam->SetTextItemArr(DynamicArray); //    StampPtr Stamp; Stamp=(StampPtr)Document2D->GetStamp(); //     Stamp->ksOpenStamp(); Stamp->ksColumnNumber(1); Stamp->ksTextLine(TextLineParam); //     Stamp->ksCloseStamp(); Stamp.Unbind(); TextItemParam.Unbind(); TextLineParam.Unbind(); DynamicArray->ksDeleteArray(); DynamicArray.Unbind(); Document2D.Unbind(); //   kompas->Visible = true; kompas.Unbind(); 

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

आप दूसरे विशेष वर्ण के आउटपुट के साथ SPECIAL_SYMBOL_END ध्वज को संयोजित नहीं कर सकते। चूंकि इस मामले में यह ध्वज दोनों विशेष वर्णों की कार्रवाई को रद्द कर देगा। लाइन "पेज 2" को स्ट्राइकथ्रू के बिना प्रदर्शित किया जाएगा।

नीचे दिया गया आंकड़ा शीर्षक ब्लॉक में कार्यक्रम द्वारा प्रदर्शित लाइन दिखाता है।



जैसा कि आप देख सकते हैं, अब विशेष वर्णों की कार्रवाई केवल "आपके" घटक पर लागू होती है।

नेस्टेड स्पेशल सिंबल

हमारे आज के पाठ का पहला उदाहरण स्पष्ट रूप से दिखाता है - विशेष वर्ण एक दूसरे में एम्बेडेड हो सकते हैं। SPECIAL_SYMBOL_END ध्वज विशेष वर्ण की एक (अंतिम) क्रिया को रद्द करता है। यह आपको एम्बेडेड विशेष वर्णों के साथ जटिल लाइनें बनाने की अनुमति देता है।

नीचे संशोधित उदाहरण का स्रोत कोड है, जिसमें वर्गाकार रूट साइन के नीचे एक्सप्रेशन "पेज 2" भी शामिल है।

 //     TextItemParamPtr TextItemParam; TextItemParam=(TextItemParamPtr)kompas->GetParamStruct(ko_TextItemParam); //     DynamicArrayPtr DynamicArray; DynamicArray=(DynamicArrayPtr)kompas->GetDynamicArray(TEXT_ITEM_ARR); //   TextItemParam->set_type(SPECIAL_SYMBOL); TextItemParam->set_iSNumb(98); BSTR str = SysAllocString(L"1 "); TextItemParam->set_s(str); SysFreeString(str); DynamicArray->ksAddArrayItem(-1, TextItemParam); //   TextItemParam->Init(); TextItemParam->set_type(SPECIAL_SYMBOL); TextItemParam->set_iSNumb(169); str = SysAllocString(L"2 "); TextItemParam->set_s(str); SysFreeString(str); DynamicArray->ksAddArrayItem(-1, TextItemParam); //   TextItemFontPtr TextItemFont; TextItemParam->Init(); TextItemFont=(TextItemFontPtr)TextItemParam->GetItemFont(); TextItemFont->set_bitVector(SPECIAL_SYMBOL_END); DynamicArray->ksAddArrayItem(-1, TextItemParam); //      TextItemParam->set_type(0); str = SysAllocString(L"  3"); TextItemParam->set_s(str); SysFreeString(str); DynamicArray->ksAddArrayItem(-1, TextItemParam); TextItemFont.Unbind(); //   ksTextLineParam TextLineParamPtr TextLineParam; TextLineParam=(TextLineParamPtr)kompas->GetParamStruct(ko_TextLineParam); TextLineParam->SetTextItemArr(DynamicArray); //    StampPtr Stamp; Stamp=(StampPtr)Document2D->GetStamp(); //     Stamp->ksOpenStamp(); Stamp->ksColumnNumber(1); Stamp->ksTextLine(TextLineParam); //     Stamp->ksCloseStamp(); Stamp.Unbind(); TextItemParam.Unbind(); TextLineParam.Unbind(); DynamicArray->ksDeleteArray(); DynamicArray.Unbind(); Document2D.Unbind(); //   kompas->Visible = true; kompas.Unbind(); 

कृपया ध्यान दें कि स्ट्रिंग "पेज 2" के प्रतिस्थापन के बाद , हम ध्वज के साथ घटक को दो बार आउटपुट करते हैं SPECIAL_SYMBOL_END (पहली बार - एक खाली घटक के भाग के रूप में, दूसरा - स्ट्रिंग "पेज 3" के साथ )। विशेष वर्णों की कार्रवाई को रद्द करना आवश्यक है। पहली बार हम विशेष चरित्र 169 (स्ट्राइकथ्रू) को रद्द करते हैं, दूसरी बार - 98 (वर्गमूल)। यदि हम ध्वज के साथ केवल एक घटक प्रदर्शित करते हैं SPECIAL_SYMBOL_END , तो यह केवल विशेष वर्ण 169 को रद्द कर देगा, लेकिन 98 नहीं। इस स्थिति में, लाइन "पृष्ठ 3" को पार नहीं किया जाएगा, लेकिन रूट साइन के तहत अभिव्यक्ति में शामिल किया जाएगा।
नीचे दिया गया आंकड़ा इस कार्यक्रम का परिणाम दिखाता है।



निष्कर्ष

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

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

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