Series صف

Series صف

يقوم بتغليف الكائن الذي يمثل سلسلة بيانات واحدة في مخطط.

يكشف النوع Series عن الأعضاء التاليين:

ملكيات

ملكيةوصف
is_filteredيشير إلى ما إذا كانت السلسلة محددة أو تمت تصفيتها. ويمثل صحيح أن هذه السلسلة تمت تصفيتها، ولن يتم عرضها على المخطط.
layout_propertiesيمثل خصائص التخطيط.
pointsالحصول على مجموعة النقاط في سلسلة في الرسم البياني.
areaيمثل منطقة الخلفية لكائن السلسلة.
borderيمثل حدود كائن السلسلة.
nameالحصول على أو تعيين اسم سلسلة البيانات.
display_nameيحصل على اسم السلسلة الذي يتم عرضه على الرسم البياني للمخطط.
count_of_data_valuesيحصل على عدد قيم البيانات.
is_vertical_valuesيشير إلى ما إذا كان مصدر البيانات عموديًا.
valuesيمثل بيانات سلسلة الرسم البياني.
values_format_codeيمثل رمز تنسيق NumberList الخاص بالقيم.
x_valuesيمثل قيم x لسلسلة المخطط.
bubble_sizesالحصول على قيم أحجام الفقاعات لسلسلة المخططات أو تعيينها.
trend_linesتقوم بإرجاع كائن يمثل مجموعة من كافة خطوط الاتجاه للسلسلة.
smoothيمثل تنعيم المنحنى.
صحيح إذا تم تشغيل تجانس المنحنى للمخطط الخطي أو المخطط المبعثر.
ينطبق فقط على المخططات الخطية والمبعثرة المتصلة بواسطة المخططات الخطية.
shadowصحيح إذا كانت السلسلة لها ظل.
has_3d_effectصحيح إذا كانت السلسلة ذات مظهر ثلاثي الأبعاد.
ينطبق فقط على المخططات الفقاعية.
bar_3d_shape_typeالحصول على نوع الشكل ثلاثي الأبعاد المستخدم مع المخطط الشريطي أو العمودي ثلاثي الأبعاد أو تعيينه.
data_labelsيمثل كائن DataLabels لـ ASeries المحدد.
typeالحصول على نوع سلسلة البيانات أو تعيينه.
markerيحصل على Series.marker.
plot_on_second_axisيشير إلى ما إذا تم رسم هذه السلسلة على محور القيمة الثاني.
x_error_barيمثل شريط خطأ الاتجاه X للسلسلة.
y_error_barيمثل شريط خطأ الاتجاه Y للسلسلة.
has_hi_lo_linesصحيح إذا كان المخطط الخطي يحتوي على خطوط مرتفعة ومنخفضة.
ينطبق فقط على المخططات الخطية.
hi_lo_linesإرجاع كائن HiLoLines الذي يمثل الخطوط العالية والمنخفضة لسلسلة على مخطط خطي.
ينطبق فقط على المخططات الخطية.
has_series_linesصحيح إذا كان المخطط العمودي أو المخطط الشريطي المكدس يحتوي على خطوط متسلسلة أو
إذا كان المخطط الدائري الدائري أو المخطط الشريطي الدائري يحتوي على خطوط موصل بين القسمين.
ينطبق فقط على المخططات العمودية المكدسة، أو المخططات الشريطية، أو المخططات الدائرية الدائرية، أو المخططات الشريطية الدائرية.
series_linesتقوم بإرجاع كائن SeriesLines الذي يمثل خطوط السلسلة لمخطط شريطي مكدس أو مخطط عمودي مكدس.
ينطبق فقط على المخططات الشريطية والمخططات العمودية المكدسة.
has_drop_linesصحيح إذا كان المخطط يحتوي على خطوط إسقاط.
ينطبق فقط على المخطط الخطي أو المخططات المساحية.
drop_linesتقوم بإرجاع كائن Line الذي يمثل الخطوط المسقطة لسلسلة على المخطط الخطي أو المخطط المساحي.
ينطبق فقط على المخطط الخطي أو المخططات المساحية.
has_up_down_barsصحيح إذا كان المخطط الخطي يحتوي على أشرطة لأعلى ولأسفل.
ينطبق فقط على المخططات الخطية.
up_barsإرجاع كائن DropBars الذي يمثل الأشرطة العلوية على مخطط خطي.
ينطبق فقط على المخططات الخطية.
down_barsتقوم بإرجاع كائن DropBars الذي يمثل الأشرطة السفلية على المخطط الخطي.
ينطبق فقط على المخططات الخطية.
is_color_variedيمثل إذا كان لون النقاط متنوعًا.
يجب أن يحتوي المخطط على سلسلة واحدة فقط.
gap_widthإرجاع المسافة بين مجموعات الأشرطة أو الأعمدة أو تعيينها، كنسبة مئوية من عرض الشريط أو العمود.
يجب أن تكون قيمة هذه الخاصية بين 0 و500.
first_slice_angleالحصول على أو تعيين زاوية أول شريحة من المخطط الدائري أو المخطط الدائري المجوف، بالدرجات (في اتجاه عقارب الساعة من الوضع الرأسي).
ينطبق فقط على المخططات الدائرية والدائرية ثلاثية الأبعاد والمخططات الدائرية الدائرية من 0 إلى 360.
overlapيحدد كيفية وضع الأشرطة والأعمدة.
يمكن أن تكون قيمة بين – 100 و100.
ينطبق فقط على المخططات الشريطية والعمودية ثنائية الأبعاد.
second_plot_sizeإرجاع أو تعيين حجم القسم الثانوي إما لمخطط دائري أو شريطي للمخطط الدائري،
كنسبة مئوية من حجم الفطيرة الأساسية.
يمكن أن تكون قيمة من 5 إلى 200.
split_typeإرجاع أو تعيين قيمة توضح كيفية تحديد نقاط البيانات الموجودة في الدائرة أو الشريط الثاني في الدائرة الدائرية أو شريط
مخطط دائري.
split_valueإرجاع أو تعيين القيمة التي يجب استخدامها لتحديد نقاط البيانات الموجودة في الدائرة أو الشريط الثاني
فطيرة فطيرة أو شريط من الرسم البياني الدائري.
is_auto_splitيشير إلى ما إذا كانت قيمة العتبة تلقائية.
bubble_scaleالحصول على عامل القياس للفقاعات الموجودة في مجموعة المخططات المحددة أو تعيينه.
يمكن أن تكون قيمة عددية من 0 (صفر) إلى 300،
المقابلة لنسبة مئوية من الحجم الافتراضي.
ينطبق فقط على المخططات الفقاعية.
size_representsالحصول على ما يمثله حجم الفقاعة في المخطط الفقاعي أو تعيينه.
show_negative_bubblesصحيح إذا تم عرض الفقاعات السالبة لمجموعة المخطط. صالح فقط للمخططات الفقاعية.
doughnut_hole_sizeإرجاع أو تعيين حجم الفتحة في مجموعة المخططات الدائرية المجوفة.
يتم التعبير عن حجم الثقب كنسبة مئوية من حجم المخطط، بين 10 و90 بالمائة.
explosionيتم التعبير عن المسافة بين الشريحة الدائرية المفتوحة ومركز المخطط الدائري كنسبة مئوية من قطر الدائرة الدائرية.
has_radar_axis_labelsصحيح إذا كان المخطط النسيجي يحتوي على تسميات محور الفئة. ينطبق فقط على المخططات الرادارية.
has_leader_linesصحيح إذا كانت السلسلة تحتوي على خطوط رئيسية.
leader_linesيمثل الخطوط الرائدة على الرسم البياني. تربط الخطوط الرائدة تسميات البيانات بنقاط البيانات.
هذا الكائن ليس مجموعة؛ لا يوجد كائن يمثل سطرًا رئيسيًا واحدًا.
legend_entryيحصل على إدخال وسيلة الإيضاح وفقًا لهذه السلسلة.
shape_propertiesيحصل على الكائن ShapePropertyCollection الذي يحمل خصائص الشكل المرئي للسلسلة.

طُرق

طريقةوصف
moveيحرك السلسلة لأعلى أو لأسفل.

مثال

from aspose.cells import Workbook
from aspose.cells.charts import ChartMarkerType, ChartType, FormattingType
from aspose.pydrawing import Color

# Instantiating a Workbook object
workbook = Workbook()
# Adding a new worksheet to the Excel object
sheetIndex = workbook.worksheets.add()
# Obtaining the reference of the newly added worksheet by passing its sheet index
worksheet = workbook.worksheets[sheetIndex]
# Adding a sample value to "A1" cell
worksheet.cells.get("A1").put_value(50)
# Adding a sample value to "A2" cell
worksheet.cells.get("A2").put_value(100)
# Adding a sample value to "A3" cell
worksheet.cells.get("A3").put_value(150)
# Adding a sample value to "A4" cell
worksheet.cells.get("A4").put_value(200)
# Adding a sample value to "B1" cell
worksheet.cells.get("B1").put_value(60)
# Adding a sample value to "B2" cell
worksheet.cells.get("B2").put_value(32)
# Adding a sample value to "B3" cell
worksheet.cells.get("B3").put_value(50)
# Adding a sample value to "B4" cell
worksheet.cells.get("B4").put_value(40)
# Adding a sample value to "C1" cell as category data
worksheet.cells.get("C1").put_value("Q1")
# Adding a sample value to "C2" cell as category data
worksheet.cells.get("C2").put_value("Q2")
# Adding a sample value to "C3" cell as category data
worksheet.cells.get("C3").put_value("Y1")
# Adding a sample value to "C4" cell as category data
worksheet.cells.get("C4").put_value("Y2")
# Adding a chart to the worksheet
chartIndex = worksheet.charts.add(ChartType.COLUMN, 5, 0, 15, 5)
# Accessing the instance of the newly added chart
chart = worksheet.charts[chartIndex]
# Adding NSeries (chart data source) to the chart ranging from "A1" cell to "B4"
seriesIndex = chart.n_series.add("A1:B4", True)
# Setting the data source for the category data of NSeries
chart.n_series.category_data = "C1:C4"
series = chart.n_series[seriesIndex]
# Setting the values of the series.
series.values = "=B1:B4"
# Changing the chart type of the series.
series.type = ChartType.LINE
# Setting marker properties.
series.marker.marker_style = ChartMarkerType.CIRCLE
series.marker.foreground_color_set_type = FormattingType.AUTOMATIC
series.marker.foreground_color = Color.black
series.marker.background_color_set_type = FormattingType.AUTOMATIC
# do your business
# Saving the Excel file
workbook.save("book1.xls")

أنظر أيضا