Grafikleriyle Çalışma
Grafikleriyle Çalışma
Aspose.Cells FOSS for Java preserves embedded charts when loading and saving XLSX workbooks. You can inspect existing charts, query their type and position, and add new standard-type charts programmatically. ChartEx types such as Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, and Map are preserved on round-trip but cannot be created through the API.
Overview
Bir çalışma sayfasındaki grafikler, bir çalışma sayfasında yönetilir. ChartCollection erişimi üzerinden Worksheet.getCharts().Her biri Chart Adı, adı ve grafik türü ile ilgili olarak belirtilmiştir., 2 hücre ankar pozisyonu. yeni bir grafik yerleştirilir ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn), Yeni oluşturulan grafiklerin indeksleri geri getirir.
O zamanlar ChartType enum, grafik varyantını (bar, çizgi, pie vb.) tanımlar. Yardımcı yöntemler ChartCollection.parseChartType(string) ve ChartCollection.chartTypeToString(ChartType) Enum ve serializasyon kullanım vakaları için çerçeve temsil.
Ana Sınıflar
| Class | Description |
|---|---|
Chart | Bir çalışma sayfasında yerleşik bir grafik temsil eder. ad, tip ve hücre anchor pozisyonuna erişimi okuyun. |
ChartCollection | Bir çalışma sayfasındaki tüm grafiklerin toplanması. sayma, indeksleme erişimi, ekleme ve grafik tipi dönüşüm yardımcıları destekler. |
ChartType | Enum, grafik varyantını tanımlar (bar, sütun, çizgi, pie, scatter vb.). |
ChartModel | Bir grafik için iç serializasyon modeli. yükleme / depolama sırasında kullanılan ham XML alanlarını gösterir. |
Bir çalışma sayfasındaki grafiklere erişmek
Retrade için ChartCollection Herhangi bir Worksheet Object üzerinden Worksheet.getCharts().Kullanım ChartCollection.getCount() kaç sayıda belirlemek için grafikler mevcuttur. bireysel grafiklerin sıfır tabanlı endeksle erişimi sağlanır. ChartCollection.get(index).
Bir kez tuttuğunuzda bir Chart Okuduğunuz referanslar:
Chart.getName()- Haritanın iç adı çubuğu.Chart.getChartType()- OChartTypeEnum değerleri.Chart.getUpperLeftRow()/Chart.getUpperLeftColumn()- Yukarı sol anchor hücresi.Chart.getLowerRightRow()/Chart.getLowerRightColumn()sağ alt ankar hücresi.Chart.getExtentCx()/Chart.getExtentCy()- Harita EMU’larda genişlemektedir.
Yeni bir haritayı eklemek
Kullanım ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn) Yeni bir grafik girin. yöntem, grafikteki bütün endeksleri geri getirir Toplam Ücretler - A ChartType değerler için de type Bir Süt ve bir hücre Range string (örneğin, A1:B5) için dataRange.
Not: ChartEx aile türleri (Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map) XLSX dosyalarını yüklediğinizde korunur ancak bu API aracılığıyla programlı olarak oluşturulamaz.
API Referans Özetleri
Chart
| Method | Geri Dönüş Türü | Description |
|---|---|---|
getName() | String | Haritanın iç adı. |
getChartType() | ChartType | Karakter değişken enum değeridir. |
getUpperLeftRow() | int | Yukarıdaki sol ankorun çizgi indeksi. |
getUpperLeftColumn() | int | Yukarıdaki sol ankorun sütunu indeksi. |
getLowerRightRow() | int | Aşağı sağ anchor indeksi. |
getLowerRightColumn() | int | Kolon endeksi sağ alt ankorun. |
getExtentCx() | long | EMU’larda genişlik haritası. |
getExtentCy() | long | EMU’da yükseklik haritası. |
ChartCollection
| Method | Geri Dönüş Türü | Description |
|---|---|---|
getCount() | int | Çalışma sayfasındaki grafik sayısı. |
get(index) | Chart | Tabloyu verilen sıfır tabanlı endeksine geri getirir. |
add(type, dataRange, ...) | int | Yeni bir grafik ekledi; indeksleri geri getiriyor. |
parseChartType(string) | ChartType | Bir çubuk adı bir ChartType Enum değerleri. |
chartTypeToString(type) | String | dönüştürücü a ChartType Enum değerinin çubuk adı ile. |
Limitations
- ChartEx türleri (Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map) yuvarlak bir verbatimdir ancak API aracılığıyla oluşturulamaz.
- Şekil veri serisi bağlantıları bu sürümde değiştirilemez; şekilleri oluşturma zamanında sağlanan orijinal veri aralığına dayanarak sunar.