Aspose.Cells FOSS
Java
डेवलपर गाइड
Working with Charts

चार्ट्स के साथ काम करना

चार्ट्स के साथ काम करना

Aspose.Cells FOSS for Java XLSX कार्यपुस्तिकाओं को लोड और सहेजते समय एम्बेडेड चार्ट्स को संरक्षित करता है। आप मौजूदा चार्ट्स की जांच कर सकते हैं, उनके प्रकार और स्थिति पूछ सकते हैं, और प्रोग्रामेटिक रूप से नए मानक-प्रकार के चार्ट जोड़ सकते हैं। ChartEx प्रकार जैसे Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, और Map राउंड-ट्रिप पर संरक्षित रहते हैं लेकिन उन्हें API के माध्यम से नहीं बनाया जा सकता।

अवलोकन

वर्कशीट में चार्ट्स को ChartCollection के माध्यम से प्रबंधित किया जाता है, जिसे Worksheet.getCharts() से एक्सेस किया जाता है। प्रत्येक Chart इंस्टेंस अपना नाम, चार्ट प्रकार, और दो-सेल एंकर स्थिति प्रदर्शित करता है। एक नया चार्ट ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn) के साथ डाला जाता है, जो नए बनाए गए चार्ट का इंडेक्स लौटाता है।

ChartType enum चार्ट वैरिएंट (बार, लाइन, पाई, आदि) को पहचानता है। हेल्पर मेथड्स ChartCollection.parseChartType(string) और ChartCollection.chartTypeToString(ChartType) सीरियलाइज़ेशन उपयोग मामलों के लिए enum और उसकी स्ट्रिंग प्रतिरूप के बीच रूपांतरण करते हैं।

मुख्य क्लासेज

क्लासविवरण
Chartएक कार्यपत्र में एम्बेडेड चार्ट का प्रतिनिधित्व करता है। नाम, प्रकार, और सेल-ऐंकर स्थिति तक पढ़ने की पहुंच।
ChartCollectionएक कार्यपत्र पर सभी चार्ट्स का संग्रह। गिनती, अनुक्रमांक पहुंच, जोड़ना, और चार्ट-प्रकार रूपांतरण सहायक को समर्थन देता है।
ChartTypeचार्ट वैरिएंट (बार, कॉलम, लाइन, पाई, स्कैटर आदि) को पहचानने वाला एनीम।
ChartModelएक चार्ट के लिए आंतरिक सीरियलाइज़ेशन मॉडल। लोड/सेव के दौरान उपयोग किए जाने वाले कच्चे XML फ़ील्ड्स को उजागर करता है।

वर्कशीट पर चार्ट्स तक पहुँच

किसी भी Worksheet ऑब्जेक्ट से ChartCollection को Worksheet.getCharts() के माध्यम से प्राप्त करें। यह निर्धारित करने के लिए कि कितने चार्ट मौजूद हैं, ChartCollection.getCount() का उपयोग करें। व्यक्तिगत चार्ट्स को ChartCollection.get(index) के माध्यम से शून्य-आधारित इंडेक्स द्वारा एक्सेस किया जाता है।

एक बार जब आपके पास Chart संदर्भ हो, तो आप पढ़ सकते हैं:

  • Chart.getName() — चार्ट का आंतरिक नाम स्ट्रिंग।
  • Chart.getChartType() — ChartType enum मान।
  • Chart.getUpperLeftRow() / Chart.getUpperLeftColumn() — बाएँ-ऊपर एंकर सेल।
  • Chart.getLowerRightRow() / Chart.getLowerRightColumn() — नीचे-दाएँ एंकर सेल।
  • Chart.getExtentCx() / Chart.getExtentCy() — EMUs में चार्ट की सीमाएँ।

नया चार्ट जोड़ना

नया चार्ट सम्मिलित करने के लिए ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn) का उपयोग करें। यह मेथड संग्रह में चार्ट का पूर्णांक इंडेक्स लौटाता है। type तर्क के लिए ChartType मान प्रदान करें और dataRange के लिए एक सेल रेंज स्ट्रिंग (उदाहरण के लिए A1:B5) दें।

Note: ChartEx-family types (Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map) को XLSX फ़ाइलें लोड करते समय संरक्षित किया जाता है लेकिन इसे API के माध्यम से प्रोग्रामेटिक रूप से नहीं बनाया जा सकता।

API Reference सारांश

Chart

विधिवापसी प्रकारविवरण
getName()Stringचार्ट का आंतरिक नाम।
getChartType()ChartTypeचार्ट वैरिएंट enum मान।
getUpperLeftRow()intऊपरी-बाएँ एंकर का पंक्ति सूचकांक।
getUpperLeftColumn()intऊपरी-बाएँ एंकर का स्तम्भ सूचकांक।
getLowerRightRow()intनिचले-दाएँ एंकर का पंक्ति सूचकांक।
getLowerRightColumn()intनीचे-दाएँ एंकर का कॉलम इंडेक्स।
getExtentCx()longचार्ट की चौड़ाई EMUs में।
getExtentCy()longचार्ट की ऊँचाई EMUs में।

ChartCollection

विधिवापसी प्रकारविवरण
getCount()intकार्यपत्रक पर चार्टों की संख्या।
get(index)Chartदिए गए शून्य-आधारित अनुक्रमणिका पर चार्ट लौटाता है।
add(type, dataRange, ...)intएक नया चार्ट जोड़ता है; उसका इंडेक्स लौटाता है।
parseChartType(string)ChartTypeएक स्ट्रिंग नाम को ChartType एन्‍युम मान में बदलता है।
chartTypeToString(type)Stringएक ChartType एन्‍युम मान को उसकी स्ट्रिंग नाम में बदलता है।

सीमाएँ

  • ChartEx प्रकार (Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map) को मूल रूप में राउंड-ट्रिप किया जाता है लेकिन इसे API के माध्यम से नहीं बनाया जा सकता।
  • इस रिलीज़ में चार्ट डेटा सीरीज़ बाइंडिंग्स को संशोधित नहीं किया जा सकता; चार्ट निर्माण समय पर प्रदान किए गए मूल डेटा रेंज के आधार पर रेंडर होता है।

यह भी देखें

 हिन्दी