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")
أنظر أيضا
- الوحدة
aspose.cells.charts
- فئة
DropBars
- فئة
Line
- فئة
ShapePropertyCollection