الأشكال في الرسوم البيانية
إضافة عنصر تحكم التسمية إلى الرسم البياني.
توفر التسميات وسيلة لإعطاء معلومات للمستخدمين حول محتوى جدول البيانات. يسمح Aspose.Cells للبايثون via .NET لك بإضافة وتلاعب بالتسميات حتى داخل الرسوم البيانية.
توفر فئة aspose.cells.drawing.ShapeCollection طريقة تسمى add_label_in_chart تُستخدَم لإضافة عنصر تحكم تسمية إلى رسم بياني. فيما يلي قائمة بالمعلمات المستخدمة للطريقة:
- الأعلى - الإزاحة الرأسية للتسمية عن الزاوية اليسرى العلوية بوحدات تمثل 1/4000 من منطقة الرسم البياني.
- اليسار - الإزاحة الرأسية للتسمية عن الزاوية اليسرى العلوية بوحدات تمثل 1/4000 من منطقة الرسم البياني.
- الارتفاع - ارتفاع التسمية، بوحدات تمثل 1/4000 من منطقة الرسم البياني.
- العرض - عرض التسمية، بوحدات تمثل 1/4000 من منطقة الرسم البياني.
تعيد الطريقة كائن aspose.cells.drawing.Label. فئة Label تمثل تسمية في الرسم البياني. لديها بعض الأعضاء المهمة.
المثال التالي يوضح كيفية إضافة تسمية إلى الرسم البياني. يستخدم المثال ملف مصمم (exp_piechart.xls) الذي يحتوي على رسم بياني فيه. نستخدم هذا الملف لإدراج تسمية في الرسم البياني. وفيما يلي الشفرة الأصلية لإضافة تسمية إلى الرسم البياني. يتم إنشاء الناتج التالي عند تنفيذ الشفرة.
| from aspose.cells import Workbook | |
| from aspose.cells.drawing import PlacementType | |
| # For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET | |
| # The path to the documents directory. | |
| dataDir = RunExamples.GetDataDir(".") | |
| # Open the existing file. | |
| workbook = Workbook(dataDir + "chart.xls") | |
| # Get the designer chart in the second sheet. | |
| sheet = workbook.worksheets[1] | |
| chart = sheet.charts[0] | |
| # Add a new label to the chart. | |
| label = chart.shapes.add_label_in_chart(100, 100, 350, 900) | |
| # Set the caption of the label. | |
| label.text = "A Label In Chart" | |
| # Set the Placement Type, the way the | |
| # Label is attached to the cells. | |
| label.placement = PlacementType.FREE_FLOATING | |
| # Save the excel file. | |
| workbook.save(dataDir + "chart.out.xls") |
إضافة عنصر تحكم مربع نص إلى الرسم البياني
أحد الطرق لتسليط الضوء على معلومات مهمة في تقرير هو استخدام مربع نص. على سبيل المثال ، أدخل نصًا لتسليط الضوء على اسم الشركة أو للإشارة إلى المنطقة الجغرافية ذات أعلى مبيعات. توفر صف الفصل aspose.cells.drawing.ShapeCollection طريقة تسمى add_text_box_in_chart ، التي تُستخدم لإضافة عنصر تحكم مربع نص إلى رسم بياني. وفيما يلي قائمة المعلمات المستخدمة للطريقة:
- top - الإزاحة الرأسية لمربع النص من الزاوية اليسرى العلوية بوحدات 1/4000 من منطقة الرسم البياني.
- left - الإزاحة الرأسية لمربع النص من الزاوية اليسرى العلوية بوحدات 1/4000 من منطقة الرسم البياني.
- height - ارتفاع مربع النص ، بوحدات 1/4000 من منطقة الرسم البياني.
- width - عرض مربع النص ، بوحدات 1/4000 من منطقة الرسم البياني.
تُرجع الطريقة كائنًا aspose.cells.drawing.TextBox. صف الفصل TextBox يمثل عنصر تحكم مربع نص في الرسم البياني.
المثال التالي يوضح كيفية إضافة مربع نص إلى رسم بياني. يستخدم المثال الملف المصمم السابق (exp_piechart.xls) الذي يحتوي على رسم بياني فيه. نستخدم هذا الملف لإدراج مربع نص في الرسم البياني لعرض عنوان الرسم البياني. يتم إنشاء الشفرة الأصلية لإضافة مربع نص إلى الرسم البياني أدناه.
| from aspose.cells import Workbook | |
| from aspose.cells.drawing import MsoLineDashStyle | |
| from aspose.pydrawing import Color | |
| # For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET | |
| # The path to the documents directory. | |
| dataDir = RunExamples.GetDataDir(".") | |
| # Open the existing file. | |
| workbook = Workbook(dataDir + "chart.xls") | |
| # Get the designer chart in the second sheet. | |
| sheet = workbook.worksheets[1] | |
| chart = sheet.charts[0] | |
| # Add a new textbox to the chart. | |
| textbox0 = chart.shapes.add_text_box_in_chart(100, 1100, 350, 2550) | |
| # Fill the text. | |
| textbox0.text = "Sales By Region" | |
| # Get the textbox text frame. | |
| # Aspose.Cells.Drawing.MsoTextFrame textframe0 = textbox0.TextFrame; | |
| # Set the textbox to adjust it according to its contents. | |
| # textframe0.AutoSize = true; | |
| # Set the font color. | |
| textbox0.font.color = Color.maroon | |
| # Set the font to bold. | |
| textbox0.font.is_bold = True | |
| # Set the font size. | |
| textbox0.font.size = 14 | |
| # Set font attribute to italic. | |
| textbox0.font.is_italic = True | |
| # Get the filformat of the textbox. | |
| fillformat = textbox0.fill | |
| # Get the lineformat type of the textbox. | |
| lineformat = textbox0.line | |
| # Set the line weight. | |
| lineformat.weight = 2.0 | |
| # Set the dash style to solid. | |
| lineformat.dash_style = MsoLineDashStyle.SOLID | |
| # Save the excel file. | |
| workbook.save(dataDir + "chart.out.xls") |
إضافة صورة إلى الرسم البياني
يتيح Aspose.Cells for Python via .NET إدراج الصور في مخطط. على سبيل المثال، أضف صورة لتأكيد أو إعطاء مزيد من المعنى لمخطط أو محتوياته، أو أدخل ملف صورة علامة تجارية.
يوفر صف الفصل aspose.cells.drawing.ShapeCollection طريقة تسمى add_picture_in_chart ، والتي تُستخدم لإضافة كائن صورة إلى الرسم البياني. وفيما يلي قائمة المعلمات المستخدمة للطريقة:
- top - الإزاحة الرأسية للصورة من الزاوية اليسرى العلوية بوحدات 1/4000 من منطقة الرسم البياني.
- left - الإزاحة الرأسية للصورة من الزاوية اليسرى العلوية بوحدات 1/4000 من منطقة الرسم البياني.
- stream - كائن تدفق يحتوي على بيانات الصورة.
- widthScale - مقياس عرض الصورة ، قيمة نسبية.
- heightScale - مقياس ارتفاع الصورة ، قيمة نسبية.
تُرجع الطريقة كائنًا aspose.cells.drawing.Picture. صف الفصل Picture يمثل كائن صورة في الرسم البياني.
المثال التالي يوضح كيفية إضافة صورة إلى الرسم البياني. يستخدم المثال الملف التصميمي السابق (exp_piechart.xls) الذي يحتوي على رسم بياني فيه. نحن نستخدم هذا الملف لإدراج صورة في الرسم البياني. أدناه هو الكود الأصلي لإضافة صورة إلى الرسم البياني.
| from aspose.cells import Workbook | |
| from aspose.cells.drawing import MsoLineDashStyle | |
| # For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET | |
| # The path to the documents directory. | |
| dataDir = RunExamples.GetDataDir(".") | |
| # Open the existing file. | |
| workbook = Workbook(dataDir + "chart.xls") | |
| # Get an image file to the stream. | |
| stream = open(dataDir + "logo.jpg", "rb") | |
| # Get the designer chart in the second sheet. | |
| sheet = workbook.worksheets[0] | |
| chart = sheet.charts[0] | |
| # Add a new picture to the chart. | |
| pic0 = chart.shapes.add_picture_in_chart(50, 50, stream, 40, 40) | |
| # Get the lineformat type of the picture. | |
| lineformat = pic0.line | |
| # Set the dash style. | |
| lineformat.dash_style = MsoLineDashStyle.SOLID | |
| # Set the line weight. | |
| lineformat.weight = 4.0 | |
| # Save the excel file. | |
| workbook.save(dataDir + "chart.out.xls") |
إضافة خانة اختيار في الرسم البياني
يتيح Aspose.Cells for Python via .NET إدراج مربعات اختيار في ورقة المخطط باستخدام MsoDrawingType enumeration. يُظهر المثال التالي إضافة مربع اختيار إلى ورقة مخطط.
الصورة التالية تظهر ورقة الرسم البياني مع خانة الاختيار في ملف الإخراج.
الملف الناتج (101089316.xlsx) الذي تم إنشاؤه بواسطة مقتطف الكود التالي مرفق للرجوع إليه.
| from aspose.cells import SheetType, Workbook | |
| from aspose.cells.charts import ChartType | |
| from aspose.cells.drawing import MsoDrawingType, PlacementType | |
| # For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET | |
| # Instantiating a Workbook object | |
| workbook = Workbook() | |
| # Adding a chart to the worksheet | |
| index = workbook.worksheets.add(SheetType.CHART) | |
| sheet = workbook.worksheets[index] | |
| sheet.charts.add_floating_chart(ChartType.COLUMN, 0, 0, 1024, 960) | |
| sheet.charts[0].n_series.add("{1,2,3}", False) | |
| # Add checkbox to the chart. | |
| sheet.charts[0].shapes.add_shape_in_chart(MsoDrawingType.CHECK_BOX, PlacementType.MOVE, 400, 400, 1000, 600) | |
| sheet.charts[0].shapes[0].text = "CheckBox 1" | |
| # Save the excel file. | |
| workbook.save(outputDir + "InsertCheckboxInChartSheet_out.xlsx") |