फ़ील्ड परिणाम स्वरूपण
फ़ील्ड परिणाम स्वरूपण
यह गाइड दिखाता है कि कैसे Aspose.Words FOSS for .NET में फ़ील्ड के गणना किए गए परिणाम पर लागू संख्यात्मक, तिथि/समय, और सामान्य स्वरूपण को नियंत्रित किया जाए, FieldFormat क्लास, GeneralFormat एन्युम, और GeneralFormatCollection का उपयोग करके। प्रत्येक Field उदाहरण इन स्वरूपण स्विचों को अपनी Format प्रॉपर्टी के माध्यम से उजागर करता है; यह पृष्ठ उस प्रॉपर्टी द्वारा प्रदान किए गए विकल्पों का गहन विश्लेषण है।
फ़ील्ड के स्वरूपण तक पहुँच
प्रत्येक Field — और उसके टाइप्ड उपवर्ग जैसे FieldDate, FieldCreateDate, और FieldSymbol — एक Format प्रॉपर्टी प्रदान करता है जिसका प्रकार FieldFormat है, जिसका उपयोग फ़ील्ड की संख्यात्मक, तिथि एवं समय, और सामान्य स्वरूपण तक टाइप्ड अभिगम के लिए किया जाता है। Field.Format पढ़ें ताकि आप फ़ील्ड कोड से जुड़े स्विचों का निरीक्षण या परिवर्तन कर सकें बिना कच्चे फ़ील्ड कोड टेक्स्ट को हाथ से संपादित किए।
संख्यात्मक और तिथि/समय स्वरूप चित्र
FieldFormat.NumericFormat एक लिखने योग्य string प्रॉपर्टी है जो संख्यात्मक फ़ील्ड परिणाम पर लागू स्वरूपण को रखती है। FieldFormat.DateTimeFormat एक लिखने योग्य string प्रॉपर्टी है जो तिथि और समय फ़ील्ड परिणाम पर लागू स्वरूपण को रखती है। किसी भी प्रॉपर्टी को सेट करें ताकि संबंधित फ़ील्ड प्रकार अपने गणना किए गए मान को कैसे प्रदर्शित करता है, इसे बदला जा सके।
सामान्य स्वरूप
FieldFormat.GeneralFormats एक GeneralFormatCollection लौटाता है — सामान्य-उद्देश्य फॉर्मेट्स जो संख्यात्मक, पाठ, या किसी भी फ़ील्ड परिणाम पर लागू होते हैं। इसके सदस्य GeneralFormat एन्म से लिए गए हैं, जिसमें केस ट्रांसफ़ॉर्म (Upper, Lower, FirstCap, Caps), रोमन और क्रमांकित संख्याएँ (UppercaseRoman, LowercaseRoman, Ordinal, OrdText), मुद्रा और कार्डिनल टेक्स्ट (DollarText, BahtText, CardText), लोकेल-विशिष्ट नंबरिंग सिस्टम (Aiueo, Arabic, ArabicAbjad, ArabicAlpha, ArabicDash, ChineseNum1–ChineseNum3, KanjiNum1–KanjiNum3, Hebrew1, Hebrew2, Ganada, Chosung, Zodiac1–Zodiac3, ThaiArabic, ThaiCardText, ThaiLetter, HindiArabic, HindiCardText, HindiLetter1, HindiLetter2, VietCardText, DBNum1–DBNum4, DBChar, SBChar, GB1–GB4, Hex, CircleNum, UppercaseAlphabetic, LowercaseAlphabetic), और मर्ज-फ़ील्ड-विशिष्ट मान CharFormat, MergeFormat, और MergeFormatInet। None सामान्य फ़ॉर्मेटिंग को साफ़ करता है।
GeneralFormatCollection का प्रबंधन
GeneralFormatCollection IEnumerable<GeneralFormat> को लागू करता है, इसलिए आप इसे GetEnumerator() के साथ एक foreach लूप में दोहरा सकते हैं। Add(item) को कॉल करके एक GeneralFormat मान जोड़ें, Remove(item) से मान की प्रत्येक उपस्थिति हटाएँ, या RemoveAt(index) से विशिष्ट स्थिति पर मान हटाएँ। Count रिपोर्ट करता है कि वर्तमान में कितने सामान्य फॉर्मेट लागू हैं।
टिप्स और सर्वोत्तम प्रथाएँ
- फ़ील्ड कोड स्ट्रिंग में सीधे फ़ॉर्मेटिंग चित्र एम्बेड करने के बजाय
Field.Format.NumericFormatयाField.Format.DateTimeFormatसेट करें — टाइप्ड प्रॉपर्टी फ़ील्ड कोड और उसके फ़ॉर्मेटिंग स्विच को सिंक्रनाइज़ रखती है। - कई
GeneralFormatमानों को (उदाहरण के लिएUpperऔरMergeFormat) प्रत्येक को अलग-अलगGeneralFormatsमें जोड़कर मिलाएँ; संग्रह एक से अधिक प्रविष्टि की अनुमति देता है। - किसी भी
FieldFormatप्रॉपर्टी को बदलने के बाद, स्वामित्व वाले फ़ील्ड परUpdate()को कॉल करें ताकि नया फ़ॉर्मेटिंगResult/DisplayResultमें परिलक्षित हो। - संग्रह में पुराने फ़ॉर्मेटिंग मानों को रहने देने के बजाय, सामान्य फ़ॉर्मेट एंट्री को स्पष्ट रूप से साफ़ करने के लिए
GeneralFormat.Noneका उपयोग करें। - फ़ील्ड पर कोई सामान्य फ़ॉर्मेटिंग लागू नहीं है, यह मानने से पहले
GeneralFormatCollection.Countजाँचें — एक खाली संग्रह औरNoneवाले संग्रह अलग-अलग स्थितियाँ हैं।
सामान्य समस्याएँ
| समस्या | कारण | समाधान |
|---|---|---|
NumericFormat को बदलने से कोई दृश्य प्रभाव नहीं पड़ता | परिवर्तन के बाद फ़ील्ड को पुनः गणना नहीं किया गया | किसी भी FieldFormat प्रॉपर्टी को संपादित करने के बाद फ़ील्ड पर Update() को कॉल करें |
डुप्लिकेट सामान्य फ़ॉर्मेट GeneralFormats में दिखाई देते हैं | एक ही GeneralFormat मान के लिए Add(item) को एक से अधिक बार कॉल किया गया | जांचें GeneralFormatCollection.Count या जोड़ने से पहले दोहराएँ, या पहले Remove(item) को कॉल करें |
गलत प्रविष्टि GeneralFormats से हटाई गई | RemoveAt(index) को एक ऐसे सूचकांक के साथ बुलाया गया था जो पूर्व हटाने के बाद बदल गया था | Count की जाँच करें और इंडेक्स द्वारा हटाने से पहले संग्रह को फिर से दोहराएँ |
FAQ
FieldFormat का उपयोग किस लिए किया जाता है?
यह Field.Format द्वारा प्रदर्शित टाइप्ड फ़ॉर्मेटिंग ऑब्जेक्ट है, जो फ़ील्ड के संख्यात्मक फ़ॉर्मेट (NumericFormat), तिथि/समय फ़ॉर्मेट (DateTimeFormat), और सामान्य फ़ॉर्मेट्स (GeneralFormats) तक पहुँच प्रदान करता है।
क्या किसी फ़ील्ड पर एक से अधिक सामान्य फ़ॉर्मेट लागू हो सकते हैं?
हाँ — GeneralFormats एक GeneralFormatCollection है, और आप Add एक से अधिक GeneralFormat मान इसे।
मैं फ़ील्ड से सभी सामान्य फ़ॉर्मेटिंग कैसे हटाऊँ?
Iterate GeneralFormats और प्रत्येक मान के लिए Remove(item) को कॉल करें, या विशिष्ट प्रविष्टि के लिए RemoveAt(index)।
क्या FieldFormat गुण सेट करने से फ़ील्ड के प्रदर्शित पाठ को स्वचालित रूप से रीफ़्रेश किया जाता है?
नहीं — फ़ील्ड पर Update() को कॉल करें, उसके Format गुण बदलने के बाद, ताकि Result और DisplayResult नए स्वरूपण को दर्शाएँ।
API Reference सारांश
| क्लास/मेथड | विवरण |
|---|---|
FieldFormat | फ़ील्ड के संख्यात्मक, तिथि/समय और सामान्य फ़ॉर्मेटिंग तक टाइप्ड पहुँच; Field.Format के माध्यम से उपलब्ध |
FieldFormat.NumericFormat | संख्यात्मक फ़ील्ड परिणाम पर लागू फ़ॉर्मेटिंग पिक्चर |
FieldFormat.DateTimeFormat | तिथि/समय फ़ील्ड परिणाम पर लागू फ़ॉर्मेटिंग पिक्चर |
FieldFormat.GeneralFormats | GeneralFormatCollection सामान्य फ़ॉर्मैट्स के फ़ील्ड परिणाम पर लागू |
GeneralFormat | सामान्य फ़ॉर्मेटिंग स्विचों का Enum (केस ट्रांसफ़ॉर्म, नंबरिंग सिस्टम, मर्ज-फ़ील्ड फ़ॉर्मेट्स) |
GeneralFormatCollection | टाइप्ड संग्रह GeneralFormat मानों का; Add, Remove, RemoveAt, Count, GetEnumerator |
