Chart sınıfı

Chart sınıfı

Tek bir Excel grafiğini temsil eden nesneyi kapsüller.

Chart türü aşağıdaki üyeleri ortaya çıkarır:

Özellikler

MülkTanım
styleYerleşik stili alır ve ayarlar.
chart_objectGrafikŞekil’i temsil eder;
hide_pivot_field_buttonsPivot grafik alanı düğmelerinin yalnızca grafik PivotChart olduğunda gizlenip gizlenmeyeceğini belirtir.
pivot_optionsGrafikte görünen pivot denetimlerini belirtir
pivot_sourceKaynak pivotTable’ın verileridir.
PivotSource boş değilse grafik PivotChart’tır.
plot_bySatır veya sütun bazında çizim yapılıp yapılmayacağını alır ve ayarlar.
plot_empty_cells_typeBoş hücrelerin nasıl çizileceğini alır ve ayarlar.
plot_visible_cellsSadece görünen hücrelerin çizilip çizilmeyeceğini belirtir.
plot_visible_cells_onlyYalnızca görünür hücrelerin çizilip çizilmeyeceğini belirtir.
display_na_as_blank#N/A değerinin boş değer olarak görüntülenip görüntülenmeyeceğini belirtir.
nameGrafiğin adını alır ve ayarlar.
size_with_windowMicrosoft Excel, grafiği grafik sayfası penceresinin boyutuna uyacak şekilde yeniden boyutlandırırsa doğrudur.
worksheetBu grafiği içeren çalışma sayfasını alır.
shapesBu grafikteki tüm çizim şekillerini döndürür.
print_sizeYazdırılan grafik boyutunu alır ve ayarlar.
typeBir grafiğin türünü alır veya ayarlar.
n_seriesGrafikteki veri serisini temsil eden SeriesCollection koleksiyonunu alır.
filtered_n_seriesGrafikte filtrelenen veri serisini temsil eden SeriesCollection koleksiyonunu alır.
titleTablonun başlığını alır.
sub_titleTablonun alt başlığını alır.
Sadece ODS formatlı dosya için.
plot_areaEksen işaret etiketlerini içeren grafiğin çizim alanını alır.
chart_areaÇalışma sayfasındaki grafik alanını alır.
category_axisGrafiğin X eksenini alır.
value_axisGrafiğin Y eksenini alır.
second_value_axisGrafiğin ikinci Y eksenini alır.
second_category_axisGrafiğin ikinci X eksenini alır.
series_axisGrafiğin seri eksenini alır.
legendGrafik efsanesini alır.
chart_data_tableGrafik veri tablosunu temsil eder.
show_legendGrafik açıklamasının görüntülenip görüntülenmeyeceğini belirten bir değer alır veya ayarlar. Varsayılan değeri true’dur.
is_rectangular_corneredGrafik alanının dikdörtgen köşeli olup olmadığını gösteren bir değer alır veya ayarlar.
Varsayılan değer doğrudur.
show_data_tableGrafiğin bir veri tablosu gösterip göstermediğini belirten bir değeri alır veya ayarlar.
first_slice_angleİlk pasta grafiği veya halka grafiği diliminin açısını derece cinsinden (dikeyden saat yönünde) alır veya ayarlar.
Sadece pasta, 3 boyutlu pasta ve halka grafikler için geçerlidir, 0 ila 360.
gap_widthÇubuk veya sütun kümeleri arasındaki boşluğu, çubuk veya sütun genişliğinin yüzdesi olarak döndürür veya ayarlar.
Bu özelliğin değeri 0 ile 500 arasında olmalıdır.
gap_depthboyutlu bir grafikte veri serileri arasındaki mesafeyi, işaretleyici genişliğinin yüzdesi olarak alır veya ayarlar.
Bu özelliğin değeri 0 ile 500 arasında olmalıdır.
floor3 boyutlu bir grafiğin duvarlarını temsil eden Chart.floor nesnesini döndürür.
walls3 boyutlu bir grafiğin duvarlarını temsil eden Chart.walls nesnesini döndürür.
back_wall3 boyutlu bir grafiğin arka duvarını temsil eden Chart.walls nesnesini döndürür.
side_wall3 boyutlu bir grafiğin yan duvarını temsil eden Chart.walls nesnesini döndürür.
walls_and_gridlines_2d3 boyutlu bir grafikte iki boyutlu olarak ızgara çizgileri çiziliyorsa doğrudur.
rotation_angle3 boyutlu grafik görünümünün dönüşünü (grafik alanının z ekseni etrafındaki dönüşünü, derece cinsinden) temsil eder.
elevation3 boyutlu grafik görünümünün yüksekliğini derece cinsinden temsil eder.
right_angle_axesGrafik eksenleri dik açılıysa doğrudur. Sadece 3 boyutlu grafikler için geçerlidir (Sütun3B ve 3 boyutlu pasta grafikleri hariç).
auto_scalingMicrosoft Excel, 3 boyutlu grafiği eşdeğer 2 boyutlu grafiğe daha yakın olacak şekilde ölçeklendirirse doğrudur.
RightAngleAxes özelliği True olmalıdır.
height_percent3 boyutlu grafiğin yüksekliğini grafik genişliğinin yüzdesi olarak döndürür veya ayarlar (yüzde 5 ile 500 arasında).
perspectiveboyutlu grafik görünümü için perspektifi döndürür veya ayarlar. 0 ile 100 arasında olmalıdır.
RightAngleAxes özelliği True ise bu özellik göz ardı edilir.
is_3dGrafiğin 3 boyutlu bir grafik olup olmadığını gösterir.
depth_percent3 boyutlu bir grafiğin derinliğini, grafik genişliğinin yüzdesi olarak gösterir (%20 ile 2000 arasında).
actual_chart_sizeGrafiğin gerçek boyutunu piksel cinsinden alır.
placementGrafiğin altındaki hücrelere bağlanma şeklini gösterir.
page_setupBu grafikteki sayfa düzeni açıklamasını temsil eder.
lineÇizgiyi alır.

Yöntemler

YöntemTanım
calculate(self)Arsa alanının özel konumunu, eksenlerin konumları otomatik olarak atanmışsa hesaplar.
calculate(self, calculate_options)Grafik Hesaplama Seçenekleri ile çizim alanının özel konumunu, eksenlerin konumları otomatik olarak atanmışsa, eksenleri hesaplar.
to_image(self, image_file)Grafik görüntüsünü oluşturur ve bir dosyaya kaydeder.
Dosya adının uzantısı, görüntünün formatını belirler.
to_image(self, image_file, image_type)Grafik görüntüsünü oluşturur ve belirtilen görüntü türündeki bir dosyaya kaydeder.
to_image(self, image_file, jpeg_quality)Grafik görüntüsünü oluşturur ve Jpeg formatında bir dosyaya kaydeder.
to_image(self, stream, jpeg_quality)Grafik görüntüsünü oluşturur ve Jpeg formatında bir akışa kaydeder.
to_image(self, stream, image_type)Grafik görüntüsünü oluşturur ve belirtilen formatta bir akışa kaydeder.
to_image(self, image_file, options)Grafik görüntüsünü oluşturur ve bir dosyaya kaydeder.
Dosya adının uzantısı, görüntünün formatını belirler.
to_image(self, stream, options)Grafik görüntüsünü oluşturur ve belirtilen formatta bir akışa kaydeder.
to_pdf(self, file_name)Tabloyu pdf dosyasına kaydeder.
to_pdf(self, file_name, desired_page_width, desired_page_height, h_alignment_type, v_alignment_type)Tabloyu pdf dosyasına kaydeder.
to_pdf(self, stream)Grafik pdf’ini oluşturur ve bunu bir akışa kaydeder.
to_pdf(self, stream, desired_page_width, desired_page_height, h_alignment_type, v_alignment_type)Grafik pdf’ini oluşturur ve bunu bir akışa kaydeder.
is_refered_by_chart(self, row_index, column_index)Tablonun referans aldığı hücrenin hangisi olduğunu döndürür.
is_cell_refered_by_chart(self, sheet_index, row_index, column_index)Tablonun referans aldığı hücrenin hangisi olduğunu döndürür.
is_chart_data_changed(self)Bir grafiğin veri kaynağının değişip değişmediğini algılar.
refresh_pivot_data(self)Pivot tablodan grafiğin verilerini yeniler.
change_template(self, data)Önceden ayarlanmış şablonla grafik türünü değiştirin.
move(self, upper_left_row, upper_left_column, lower_right_row, lower_right_column)Grafiği belirtilen konuma taşır.
get_actual_size(self)Grafiğin gerçek boyutunu piksel cinsinden alır.
has_axis(self, aixs_type, is_primary)Grafikte hangi eksenlerin bulunduğunu döndürür.
switch_row_column(self)Satır/sütun değiştirir.
get_chart_data_range(self)Grafiğin veri kaynağı aralığını alır.
set_chart_data_range(self, area, is_vertical)Bir grafik için veri aralığını belirtir.

Örnek

Aşağıdaki kodlar .Net kodlarıyla bir grafiğin nasıl oluşturulacağını göstermektedir.

from aspose.cells import Workbook
from aspose.cells.charts import ChartType

workbook = Workbook()
sheet = workbook.worksheets[0]
cells = sheet.cells
cells.get(0, 1).put_value("Income")
cells.get(1, 0).put_value("Company A")
cells.get(2, 0).put_value("Company B")
cells.get(3, 0).put_value("Company C")
cells.get(1, 1).put_value(10000)
cells.get(2, 1).put_value(20000)
cells.get(3, 1).put_value(30000)
chartIndex = sheet.charts.add(ChartType.COLUMN, 9, 9, 21, 15)
chart = sheet.charts[chartIndex]
chart.set_chart_data_range("A1:B4", True)
chart.show_legend = True
chart.title.text = "Income Analysis"

Ayrıca bakınız