کار با نمودارها

روش جدید insert_chart به کلاس DocumentBuilder اضافه شد. بنابراین، بیایید ببینیم که چگونه یک نمودار ستونی ساده را با استفاده از روش DocumentBuilder.insert_chart در سند وارد کنیم:

نحوه درج نمودار

در این بخش نحوه درج نمودار را در یک سند یاد خواهیم گرفت.

درج نمودار ستونی

مثال کد زیر نحوه درج نمودار ستونی را نشان می دهد:

کد نتیجه زیر را ایجاد می کند:

روش‌های add، add_double و add_date وجود دارد که برای پوشش همه انواع منابع داده‌ای ممکن برای همه انواع نمودار در معرض دید قرار گرفت:

کد نتیجه زیر را ایجاد می کند:

درج نمودار پراکندگی

مثال زیر نحوه درج نمودار پراکندگی را نشان می دهد.

کد نتیجه زیر را ایجاد می کند:

درج نمودار منطقه

مثال کد زیر نحوه درج نمودار منطقه را نشان می دهد:

کد نتیجه زیر را ایجاد می کند:

درج نمودار حباب

مثال کد زیر نحوه درج نمودار حباب را نشان می دهد:

کد نتیجه زیر را ایجاد می کند:

کار با نمودارها از طریق Shape.chart Object

هنگامی که نمودار درج شد و با داده ها پر شد، می توانید ظاهر آن را تغییر دهید. ویژگی Shape.chart شامل تمام گزینه های مربوط به نمودار در دسترس از طریق API عمومی است.

به عنوان مثال، اجازه دهید عنوان یا رفتار افسانه Chart را تغییر دهیم:

کد نتایج زیر را ایجاد می کند:

نحوه کار با ChartSeriesCollection of Chart

بیایید به مجموعه ChartSeries نگاه کنیم. تمام سری نمودارها از طریق مجموعه Chart.series در دسترس هستند:

می‌توانید سری‌ها را یکی یکی حذف کنید یا همه آن‌ها را پاک کنید و در صورت نیاز یک سری جدید اضافه کنید. نموداری که به تازگی درج شده است تعدادی سری پیش فرض به این مجموعه اضافه شده است. برای حذف آنها باید با روش chart.series.clear() تماس بگیرید.

کار با کلاس Single ChartSeries

در اینجا نحوه کار با یک سریال خاص است.

لطفا نتیجه را در زیر ببینید:

همه ChartSeries تک گزینه‌های ChartDataPoint پیش‌فرض دارند، لطفاً از کد زیر برای تغییر آن‌ها استفاده کنید:

لطفا نتیجه را در زیر ببینید:

نحوه کار با Single ChartDataPoint یک ChartSeries

با استفاده از ChartDataPoint می‌توانید قالب‌بندی یک نقطه داده از سری نمودار را سفارشی کنید:

لطفا نتیجه را در زیر ببینید:

نحوه کار با ChartDataLabel یک ChartSeries منفرد

با استفاده از ChartDataLabel می‌توانید قالب‌بندی یک برچسب داده از سری نمودار را مشخص کنید، مانند نمایش/پنهان کردن LegendKey، CategoryName، SeriesName، Value و غیره.

لطفا نتیجه را در زیر ببینید:

نحوه تعریف گزینه های پیش فرض برای ChartDataLabels ChartSeries

کلاس ChartDataLabelCollection ویژگی هایی را تعریف می کند که می توان از آنها برای تنظیم گزینه های پیش فرض برای ChartDataLabels برای سری نمودار استفاده کرد. این ویژگی ها عبارتند از show_category_name، show_bubble_size، show_percentage، show_series_name، show_value و غیره.

لطفا نتیجه را در زیر ببینید:

نحوه قالب بندی شماره برچسب داده نمودار

با استفاده از ChartDataLabel.number_format می توانید قالب بندی عددی یک برچسب داده واحد از نمودار را مشخص کنید.

مثال کد زیر نحوه قالب بندی تعدادی از برچسب داده ها را نشان می دهد:

نحوه تنظیم ویژگی های محور نمودار

اگر می‌خواهید با محور نمودار، مقیاس‌بندی و واحدهای نمایشی برای محور ارزش کار کنید، لطفاً از کلاس‌های ChartAxis، AxisDisplayUnit و AxisScaling استفاده کنید.

مثال کد زیر نحوه تعریف ویژگی های محور X و Y را نشان می دهد:

نحوه تنظیم مقدار زمانی محور Date

مثال کد زیر نحوه تنظیم مقادیر تاریخ/زمان به ویژگی های محور را نشان می دهد:

نحوه قالب بندی مقدار عدد محور

مثال کد زیر نحوه تغییر فرمت اعداد در محور مقدار را نشان می دهد:

نحوه تنظیم مرزهای محور

کلاس AxisBound حداقل یا حداکثر مرز مقادیر محور را نشان می دهد. Bound را می توان به عنوان یک عدد عددی، تاریخ-زمان یا یک مقدار “خودکار” خاص مشخص کرد.

مثال کد زیر نحوه تنظیم مرزهای یک محور را نشان می دهد:

نحوه تنظیم واحد فاصله بین برچسب ها

مثال کد زیر نحوه تنظیم واحد فاصله بین برچسب ها را در یک محور نشان می دهد:

نحوه پنهان کردن محور نمودار

اگر می خواهید محور نمودار را نشان دهید یا پنهان کنید، می توانید به سادگی با تنظیم مقدار ویژگی ChartAxis.hidden به این امر دست یابید.

مثال کد زیر نحوه پنهان کردن محور Y نمودار را نشان می دهد:

نحوه تراز کردن برچسب نمودار

اگر می‌خواهید یک هم‌ترازی متن برای برچسب‌های چند خطی تنظیم کنید، می‌توانید به سادگی با تنظیم مقدار ویژگی ChartAxis.tick_label_alignment به این هدف برسید.

مثال کد زیر نحوه تیک زدن تراز برچسب را نشان می دهد:

MS Word به طور پیش فرض نمودار نمودار را در مرکز تراز می کند.

نحوه تنظیم قالب بندی پر و ضربه

قالب بندی پر و استروک را می توان برای سری نمودارها، نقاط داده و نشانگرها تنظیم کرد. برای این کار باید از ویژگی های نوع ChartFormat در کلاس های ChartSeries، ChartDataPoint و ChartMarker و همچنین نام مستعار برای برخی از ویژگی ها مانند fore_color، back_color، visible و transparency در کلاس Stroke استفاده کنید.

مثال کد زیر نحوه تنظیم رنگ سری را نشان می دهد:

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

shape = builder.insert_chart(aw.drawing.charts.ChartType.COLUMN, 432, 252)

chart = shape.chart
seriesColl = chart.series

# Delete default generated series.
seriesColl.clear()

# Create category names array.
categories = [ "AW Category 1", "AW Category 2" ]

# Adding new series. Value and category arrays must be the same size.
series1 = seriesColl.add("AW Series 1", categories, [ 1, 2 ])
series2 = seriesColl.add("AW Series 2", categories, [ 3, 4 ])
series3 = seriesColl.add("AW Series 3", categories, [ 5, 6 ])

# Set series color.
series1.format.fill.fore_color = drawing.Color.red
series2.format.fill.fore_color = drawing.Color.yellow
series3.format.fill.fore_color = drawing.Color.blue

doc.save(docs_base.artifacts_dir + "WorkingWithCharts.set_series_color.docx")

مثال کد زیر نحوه تنظیم رنگ و وزن خط را نشان می دهد:

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

shape = builder.insert_chart(aw.drawing.charts.ChartType.LINE, 432, 252)

chart = shape.chart
seriesColl = chart.series

# Delete default generated series.
seriesColl.clear()

# Adding new series.
series1 = seriesColl.add_double("AW Series 1", [ 0.7, 1.8, 2.6 ], [ 2.7, 3.2, 0.8 ])
series2 = seriesColl.add_double("AW Series 2", [ 0.5, 1.5, 2.5 ], [ 3, 1, 2 ])

# Set series color.
series1.format.stroke.fore_color = drawing.Color.red
series1.format.stroke.weight = 5
series2.format.stroke.fore_color = drawing.Color.light_green
series2.format.stroke.weight = 5

doc.save(docs_base.artifacts_dir + "WorkingWithCharts.line_color_and_weight.docx")