सूचियों के साथ काम करना
अवलोकन
यह गाइड दिखाता है कि क्रमांकित और बुलेटेड सूचियों को Aspose.Words FOSS में .NET के लिए कैसे दर्शाया और नियंत्रित किया जाता है। एक List वह पुन: उपयोग योग्य सूची परिभाषा है जो इसे उपयोग करने वाले प्रत्येक पैराग्राफ द्वारा साझा की जाती है, ListFormat वह तरीका है जिससे एक व्यक्तिगत पैराग्राफ सूची और उसके वर्तमान स्तर को संदर्भित करता है, और ListLevel सूची के एक स्तर के लिए वास्तविक क्रमांक या बुलेट फ़ॉर्मेटिंग रखता है।
सूची ऑब्जेक्ट और ListCollection
List एक सूची परिभाषा का प्रतिनिधित्व करता है — वह क्रमांकन नियम जो एक दस्तावेज़ कई पैराग्राफ़ पर लागू कर सकता है। List.ListId इसे पहचानता है, List.IsMultiLevel रिपोर्ट करता है कि क्या यह एक से अधिक स्तर परिभाषित करता है, और List.ListLevels एक ListLevelCollection लौटाता है जिसमें सूची द्वारा परिभाषित प्रत्येक स्तर के लिए एक ListLevel होता है। List.IsListStyleDefinition और IsListStyleReference एक ऐसी सूची को अलग करते हैं जो अपना स्वयं का फ़ॉर्मेटिंग परिभाषित करती है बनाम वह जो लिंक किए गए Style के माध्यम से फ़ॉर्मेटिंग को संदर्भित करती है (जो List.Style के माध्यम से उपलब्ध है)। प्रत्येक दस्तावेज़ की सूचियों तक Document.Lists के माध्यम से पहुँचा जा सकता है, जो एक ListCollection लौटाता है: ListCollection.Add(listTemplate) Word के पूर्वनिर्धारित ListTemplate फ़ॉर्मेट्स में से एक से नई सूची बनाता है, Add(listStyle) एक Style से बनाता है, AddSingleLevelList(listTemplate) एक एकल-स्तर वैरिएंट बनाता है, और AddCopy(srcList) मौजूदा सूची की प्रतिलिपि बनाता है — यह तब उपयोगी होता है जब आप चाहते हैं कि पैराग्राफ़ स्वतंत्र क्रमांकन (एक नया रीस्टार्ट) रखें न कि समान काउंटर साझा करें। ListCollection.GetListByListId(listId) एक विशिष्ट सूची को प्राप्त करता है, और Count रिपोर्ट करता है कि दस्तावेज़ में कितनी सूचियाँ हैं।
पैराग्राफ़ में ListFormat के साथ सूचियों को लागू करना
ListFormat, जो पैराग्राफ़ के फ़ॉर्मेटिंग से पहुँचा जाता है, यह नियंत्रित करता है कि पैराग्राफ़ किस सूची में है और कौन से स्तर पर। ListFormat.List वह List है जो पैराग्राफ़ उपयोग करता है, और ListFormat.ListLevelNumber उस सूची के भीतर शून्य-आधारित स्तर है; IsListItem रिपोर्ट करता है कि क्या पैराग्राफ़ बिल्कुल भी सूची का हिस्सा है। ApplyBulletDefault() और ApplyNumberDefault() एक ही कॉल में Word की डिफ़ॉल्ट बुलेट या क्रमांकित सूची फ़ॉर्मेटिंग को पैराग्राफ़ पर लागू करते हैं, RemoveNumbers() सूची फ़ॉर्मेटिंग को हटाता है, और ListIndent()/ListOutdent() पैराग्राफ़ को सूची के स्तरों में गहरा या उथला ले जाते हैं — वही ऑपरेशन जो Word Tab या Shift+Tab दबाने पर सूची पैराग्राफ़ की शुरुआत में करता है।
सूची स्तर और क्रमांकन शैली
ListLevel सूची के एक स्तर के फ़ॉर्मेटिंग को रखता है: NumberStyle (एक NumberStyle enum मान जैसे Arabic numerals या Roman numerals), NumberFormat (संख्या को शाब्दिक पाठ के साथ जोड़ने वाली फ़ॉर्मेट स्ट्रिंग, जैसे एक बिंदु या कोष्ठक), StartAt (आरंभिक संख्या), और RestartAfterLevel (कौन सा उच्च स्तर का इन्क्रीमेंट इस स्तर के काउंटर को रीस्टार्ट करता है)। Alignment (एक ListLevelAlignment मान: Left, Center, Right) और TrailingCharacter (एक ListTrailingCharacter मान: Tab, Space, Nothing) लेबल की स्थिति और पैराग्राफ टेक्स्ट से अलगाव को नियंत्रित करते हैं, साथ ही सटीक लेआउट के लिए TabPosition, NumberPosition, और TextPosition। IsLegal कानूनी-शैली की नंबरिंग को मजबूर करता है (हमेशा Arabic, चाहे NumberStyle कुछ भी हो), और LinkedStyle स्तर को पैराग्राफ Style से जोड़ता है। चित्र बुलेट्स के लिए, CreatePictureBullet() और DeletePictureBullet() एक ImageData बुलेट छवि को प्रबंधित करते हैं, और ListLevel.Font संख्या या बुलेट वर्ण के फ़ॉर्मेट को निर्धारित करता है। ListLevel.GetEffectiveValue(index, numberStyle, customNumberStyleFormat) क्रमांक अनुक्रम में दिए गए स्थिति पर वास्तविक लेबल मान की गणना करता है।
सूची लेबल और पूर्वनिर्धारित टेम्प्लेट
ListLabel किसी विशिष्ट सूची आइटम इंस्टेंस के रेंडर किए गए लेबल का वर्णन करता है — LabelString वह शाब्दिक पाठ है जो Word दिखाता है (जैसे “3.” या “•”), LabelValue अंतर्निहित संख्यात्मक मान है, और Font लेबल का फॉर्मेट है। ListTemplate Word के पूर्वनिर्धारित सूची फ़ॉर्मैट्स का एक enum है (बुलेट शैलियाँ जैसे BulletDefault, BulletDisk, BulletCircle, BulletSquare, BulletDiamonds, और क्रमांकित फ़ॉर्मैट), जिसे ListCollection.Add(listTemplate) के साथ उपयोग किया जाता है ताकि एक निर्मित फ़ॉर्मैट से शुरू किया जा सके बजाय प्रत्येक प्रॉपर्टी को अलग-अलग बनाने के।
सलाह और सर्वोत्तम प्रथाएँ
- जब पैराग्राफ़ों के एक नए समूह को सूची क्रमांकन को स्वतंत्र रूप से फिर से शुरू करने की आवश्यकता होती है, तो
ListCollection.AddCopy(srcList)का उपयोग करें, बजाय उसListको पुन: उपयोग करने के जो पहले से अन्य पैराग्राफ़ों से जुड़ा है। - मानक सूचियों के लिए हर
ListLevelप्रॉपर्टी को मैन्युअल रूप से कॉन्फ़िगर करने के बजायListFormat.ApplyNumberDefault()/ApplyBulletDefault()को प्राथमिकता दें। - सूची फ़ॉर्मेटिंग को सीधे संशोधित करने से पहले
List.IsListStyleReferenceबनामIsListStyleDefinitionकी जाँच करें — एक स्टाइल-रेफ़रेंसिंग सूची का फ़ॉर्मेट उसके जुड़ेStyleद्वारा नियंत्रित हो सकता है। - जब क्रमांकन को विशिष्ट रूपरेखा स्तरों पर रीसेट करना हो, तो डिफ़ॉल्ट रीस्टार्ट व्यवहार पर निर्भर रहने के बजाय नेस्टेड सूचियों पर
RestartAfterLevelको स्पष्ट रूप से सेट करें। - वाक्यांश को सूची स्तरों के बीच ले जाने के लिए
ListFormat.ListIndent()/ListOutdent()का उपयोग करें, बजाय सीधेListLevelNumberसेट करने के, क्योंकि ये विधियाँ वाक्यांश की सूची स्वरूपण को आंतरिक रूप से सुसंगत रखती हैं।
सामान्य समस्याएँ
| समस्या | कारण | समाधान |
|---|---|---|
| दो पैराग्राफ़ जो स्वतंत्र रूप से क्रमांकित होने चाहिए, वही क्रम जारी रखते हैं | दोनों पैराग्राफ़ का ListFormat.List एक ही साझा List ऑब्जेक्ट को संदर्भित करता है | दूसरे पैराग्राफ़ को ListCollection.AddCopy(srcList) के माध्यम से अपनी सूची दें, बजाय एक ही List को पुन: उपयोग करने के |
| एक कस्टम क्रमांक स्वरूप स्ट्रिंग अपेक्षित रूप से प्रदर्शित नहीं होती है | ListLevel.NumberFormat स्तर के NumberStyle के लिए अपेक्षित पैटर्न से मेल नहीं खाता है | Verify NumberFormat and NumberStyle are set consistently for the level being edited |
| List indentation looks wrong after changing levels programmatically | ListLevelNumber was set directly without updating related position properties | Use ListFormat.ListIndent()/ListOutdent() instead of setting ListLevelNumber directly |
| A picture bullet doesn’t appear | उस स्तर के लिए कोई चित्र बुलेट नहीं बनाया गया, या डिफ़ॉल्ट टेक्स्ट बुलेट फ़ॉर्मेटिंग अभी भी सक्रिय है | टेक्स्ट बुलेट फ़ॉर्मेटिंग हटाने से पहले ListLevel.CreatePictureBullet() को कॉल करें और इमेज डेटा प्रदान करें |
FAQ
List और ListFormat में क्या अंतर है?
List वह पुन: उपयोग योग्य क्रमांक/बुलेट परिभाषा है जो पैराग्राफ़ों के बीच साझा की जाती है; ListFormat प्रति-पैराग्राफ है — यह संकेत करता है कि कोई विशिष्ट पैराग्राफ़ कौन सा List उपयोग करता है और किस स्तर पर, ListFormat.List और ListLevelNumber के माध्यम से।
मैं कैसे जाँचूँ कि कोई पैराग्राफ़ सूची का हिस्सा है?
पैराग्राफ़ की स्वरूपण पर ListFormat.IsListItem पढ़ें; यदि true, तो ListFormat.List और ListLevelNumber यह वर्णन करते हैं कि वह किस सूची और स्तर में आता है।
मैं कैसे नई सूची को मौजूदा सूची से स्वतंत्र रूप से 1 से क्रमांकित शुरू करूँ?
ListCollection.AddCopy(srcList) का उपयोग करके सूची परिभाषा की स्वतंत्र प्रति बनाएं, फिर नई अनुच्छेदों पर उस प्रति को लागू करें — मूल List को पुन: उपयोग करने के बजाय, जो समान काउंटर जारी रखेगा।
मैं शून्य से बुलेटेड या क्रमांकित सूची कैसे बनाऊँ?
Word के डिफ़ॉल्ट फ़ॉर्मेटिंग के लिए ListFormat.ApplyBulletDefault() या ApplyNumberDefault() का उपयोग करें, या ListCollection.Add(listTemplate) को ListTemplate मान के साथ उपयोग करके Word के पूर्वनिर्धारित फ़ॉर्मेट्स में से एक से शुरू करें और resulting List.ListLevels को वहाँ से कस्टमाइज़ करें।
मैं संख्या स्वरूप को कैसे नियंत्रित करूँ, जैसे “1)” के बजाय “1.”?
संबंधित स्तर पर ListLevel.NumberFormat को वांछित फ़ॉर्मेट स्ट्रिंग पर सेट करें, साथ ही NumberStyle को अंक शैली के लिए सेट करें।
API Reference सारांश
| क्लास/मेथड | विवरण |
|---|---|
List | एक पुन: उपयोग करने योग्य सूची (नंबरिंग/बुलेट) परिभाषा |
ListCollection | दस्तावेज़ में सभी सूचियों का संग्रह |
ListCollection.Add(listTemplate) / AddCopy(srcList) | एक पूर्वनिर्धारित टेम्पलेट से सूची बनाएं, या मौजूदा को कॉपी करें |
ListFormat | एक List और वर्तमान स्तर का प्रति-पैराग्राफ संदर्भ |
ListFormat.ApplyBulletDefault() / ApplyNumberDefault() | एक पैराग्राफ पर डिफ़ॉल्ट बुलेट या क्रमांकित फॉर्मेटिंग लागू करें |
ListLevel | एक स्तर के List के लिए क्रमांक/बुलेट फ़ॉर्मेटिंग |
ListLevel.NumberStyle / NumberFormat | किसी स्तर के लिए अंक शैली और फ़ॉर्मेट स्ट्रिंग |
ListLabel | किसी विशिष्ट सूची आइटम के लिए रेंडर किया गया लेबल (पाठ और मान) |
ListTemplate | Word के पूर्वनिर्धारित सूची फ़ॉर्मेट्स का Enum |