Chart — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss, çalışma sayfalarına grafik eklemeyi destekler. Grafikler, şunun aracılığıyla yönetilir ws.charts, bir ChartCollection her birine eklenmiş Worksheet. Seri verileri, şunun aracılığıyla eklenir chart.n_series,bir NSeries koleksiyon.

Enumerations: aspose.cells_foss

from aspose.cells_foss import ChartType

ChartType

ChartType bir IntEnum grafik tipini tanımlayan.

Enumerations

Chart nesneler doğrudan oluşturulmaz. Kullan ws.charts.add(...) veya tipli kolaylık yöntemleri (add_bar(), add_line(), add_pie(), add_area()).

Enumerations

ChartCollection

ChartCollection şu şekilde erişilir ws.charts. Bir çalışma sayfasına gömülmüş tüm grafikleri içerir.

Enumerations

add

ws.charts.add(
    chart_type: ChartType,
    upper_left_row: int,
    upper_left_column: int,
    lower_right_row: int,
    lower_right_column: int
) -> Chart

Belirtilen tipte bir grafik ekler. Tüm konum argümanları 0 tabanlı satır/sütun indeksleridir.

add_bar

ws.charts.add_bar(upper_left_row, upper_left_column, lower_right_row, lower_right_column) -> Chart

Kısayol: add(ChartType.BAR, ...).

add_line

ws.charts.add_line(upper_left_row, upper_left_column, lower_right_row, lower_right_column) -> Chart

Kısayol add(ChartType.LINE, ...).

add_pie

ws.charts.add_pie(upper_left_row, upper_left_column, lower_right_row, lower_right_column) -> Chart

Kısayol add(ChartType.PIE, ...).

add_area

ws.charts.add_area(upper_left_row, upper_left_column, lower_right_row, lower_right_column) -> Chart

Kısayol add(ChartType.AREA, ...).

Özellikler ve Yineleme

NSeries

NSeries şu aracılığıyla erişilir chart.n_series. Bir grafiğe ait veri serilerini yönetir.

Enumerations

add

chart.n_series.add(
    area: str,
    is_vertical: bool = False,
    category_data: str | None = None,
    name: str | None = None,
    chart_type: ChartType | None = None
) -> ChartSeries

Bir veri serisi ekler. area şu gibi bir aralık dizesidir "Sheet1!B1:B5". Ayarla is_vertical=True veri sütunlar halinde düzenlendiğinde. chart_type bu seri için üst grafik tipini geçersiz kılar (karma grafiklerde kullanılır).

Özellikler ve Yineleme

ChartSeries

ChartSeries bir grafikte tek bir veri serisini temsil eder. Şu yol ile elde edilir. chart.n_series[index].

Enumerations

Enumerations

add_error_bars

series.add_error_bars(
    direction='y',
    bar_type='both',
    val_type='fixedVal',
    val=1.0,
    no_end_cap=False
) -> ChartErrorBars

Bu seriye hata çubukları ekler ve döndürür ChartErrorBars nesneyi.

ChartAxis

ChartAxis şu yol ile erişilir chart.axes[index].

Enumerations

ChartView3D

ChartView3D şu yolla erişilir chart.view_3d. Yalnızca şu durumda uygulanır chart.is_3d şu olduğunda True.

Enumerations

ChartErrorBars

ChartErrorBars şu aracılığıyla erişilir series.error_bars. Şununla oluştur series.add_error_bars(...).

Enumerations

Enumerations

Aşağıdaki örnek aylık gelir verilerini yazar, bir başlık ve iki veri serisi içeren kümelenmiş çubuk grafik oluşturur ve çalışma kitabını kaydeder.

from aspose.cells_foss import Workbook, ChartType

wb = Workbook()
ws = wb.worksheets[0]
ws.name = "Revenue"

# Write headers and data
headers = ["Month", "Product A", "Product B"]
data = [
    ["Jan", 12000, 9500],
    ["Feb", 14500, 11000],
    ["Mar", 13200, 12800],
    ["Apr", 15800, 14100],
]
for col, h in enumerate(headers):
    ws.cells[0][col].put_value(h)
for row, row_data in enumerate(data, start=1):
    for col, val in enumerate(row_data):
        ws.cells[row][col].put_value(val)

# Add a bar chart covering rows 6-20, columns 0-6
chart = ws.charts.add_bar(6, 0, 20, 6)
chart.title = "Monthly Revenue by Product"
chart.bar_direction = "col"   # vertical (column chart)
chart.grouping = "clustered"

# Series: Product A and Product B
chart.n_series.add("Revenue!B2:B5", is_vertical=True, category_data="Revenue!A2:A5", name="Product A")
chart.n_series.add("Revenue!C2:C5", is_vertical=True, category_data="Revenue!A2:A5", name="Product B")

chart.show_legend = True
chart.legend_position = "bottom"

wb.save("revenue_chart.xlsx")

Ayrıca Bakınız

• Cells Python API Referansı ana sayfa
• Workbook sınıf referansı
• Worksheet sınıfı referansı
• Başlarken
• Geliştirici Kılavuzu