Chart
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 ChartTypeChartType
ChartType bir IntEnum grafik tipini tanımlayan.
| Name | Type | Access | Description |
|---|---|---|---|
type | `` | Read | Gets the type. |
title | `` | Read/Write | Gets or sets the title. |
category_data | `` | Read/Write | Gets or sets the category data. |
show_legend | `` | Read/Write | Gets or sets the show legend. |
legend_position | `` | Read/Write | Gets or sets the legend position. |
smooth | `` | Read/Write | Gets or sets the smooth. |
n_series | `` | Read | Gets the n series. |
NSeries | `` | Read | PascalCase alias of n_series. |
grouping | `` | Read/Write | Gets or sets the grouping. |
bar_direction | `` | Read/Write | Gets or sets the bar direction. |
gap_width | `` | Read/Write | Gets or sets the gap width. |
overlap | `` | Read/Write | Gets or sets the overlap. |
vary_colors | `` | Read/Write | Gets or sets the vary colors. |
first_slice_angle | `` | Read/Write | Gets or sets the first slice angle. |
is_of_pie | `` | Read/Write | Gets or sets the is of pie. |
of_pie_type | `` | Read/Write | Gets or sets the of pie type. |
second_pie_size | `` | Read/Write | Gets or sets the second pie size. |
quartile_method | `` | Read/Write | Gets or sets the quartile method. |
box_show_mean_line | `` | Read/Write | Gets or sets the box show mean line. |
box_show_mean_marker | `` | Read/Write | Gets or sets the box show mean marker. |
box_show_inner_points | `` | Read/Write | Gets or sets the box show inner points. |
box_show_outlier_points | `` | Read/Write | Gets or sets the box show outlier points. |
box_gap_width | `` | Read/Write | Gets or sets the box gap width. |
is_3d | `` | Read/Write | Gets or sets the is 3d. |
gap_depth | `` | Read/Write | Gets or sets the gap depth. |
view_3d | `` | Read | Gets the view 3d. |
View3D | `` | Read | PascalCase alias of view_3d. |
show_connector_lines | `` | Read/Write | Gets or sets the show connector lines. |
has_subtotals | `` | Read/Write | Gets or sets the has subtotals. |
sub_charts | `` | Read | List of sub-chart descriptors for combo charts. |
axes | `` | Read | List of ChartAxis objects defining all axes for the chart. |
scatter_style | `` | Read/Write | Gets or sets the scatter style. |
wireframe | `` | Read/Write | Whether the surface chart uses wireframe display mode (<c:wireframe val=‘1’/>). |
radar_style | `` | Read/Write | Radar chart style: ‘standard’, ‘marker’, or ‘filled’. |
histogram_bin_count | `` | Read/Write | Number of bins for count-based binning (int or None for auto/size-based). |
histogram_bin_size | `` | Read/Write | Bin width for size-based binning (float or None for auto/count-based). |
histogram_interval_closed | `` | Read/Write | Which side of each bin interval is closed: ‘r’ (right) or ’l’ (left). |
histogram_overflow | `` | Read/Write | Overflow bin boundary value (float or None). |
histogram_underflow | `` | Read/Write | Underflow bin boundary value (float or None). |
disp_blanks_as | `` | Read/Write | Gets or sets the disp blanks as. |
stock_style | `` | Read/Write | Gets or sets the stock style. |
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
| Signature | Description |
|---|---|
__init__(chart_type, upper_left_row, upper_left_column, lower_right_row, lower_right_column) | |
add_series(values, category_data, name, chart_type, x_values) | Convenience method to add a series. |
add_axis(axis_type, axis_id) | Adds an axis to the chart and returns it. |
copy() | Creates and returns a duplicate of the chart |
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
) -> ChartBelirtilen 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) -> ChartKısayol: add(ChartType.BAR, ...).
add_line
ws.charts.add_line(upper_left_row, upper_left_column, lower_right_row, lower_right_column) -> ChartKısayol add(ChartType.LINE, ...).
add_pie
ws.charts.add_pie(upper_left_row, upper_left_column, lower_right_row, lower_right_column) -> ChartKısayol add(ChartType.PIE, ...).
add_area
ws.charts.add_area(upper_left_row, upper_left_column, lower_right_row, lower_right_column) -> ChartKı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
) -> ChartSeriesBir 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
) -> ChartErrorBarsBu 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")