Series صف

Series صف

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

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

ملكيات

ملكيةوصف
is_filteredيشير إلى ما إذا كانت السلسلة محددة أو مفلترة. يمثل “صحيح” أن هذه السلسلة مفلترة، ولن يتم عرضها على الرسم البياني.
layout_propertiesيمثل خصائص التخطيط.
pointsيحصل على مجموعة من النقاط في سلسلة في الرسم البياني.
areaيمثل منطقة الخلفية لكائن السلسلة.
borderيمثل حدود كائن السلسلة.
nameيحصل على اسم سلسلة البيانات أو يعينه.
display_nameيحصل على اسم السلسلة الذي يظهر على الرسم البياني.
count_of_data_valuesيحصل على عدد قيم البيانات.
is_vertical_valuesيشير إلى ما إذا كان مصدر البيانات عموديًا.
valuesيمثل قيم Y لسلسلة الرسم البياني هذه.
values_format_codeيمثل رمز التنسيق لقائمة أرقام القيم.
x_values_format_codeيمثل رمز التنسيق لقائمة أرقام قيم X.
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(self, count)تحريك السلسلة لأعلى أو لأسفل.

مثال

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")

أنظر أيضا