الضوابط في الرسوم البيانية

تحتاج أحيانًا إلى إدراج كائنات رسومية مثل الملصقات ومربعات النص والصور وما إلى ذلك في مخطط. يمكن أن يقوم Aspose.Cells بإضافة عناصر التحكم إلى مخطط في وقت التشغيل.

إضافة عنصر تحكم التسمية إلى التخطيط

توفر التصنيفات وسيلة لإعطاء معلومات للمستخدمين حول محتوى جدول البيانات. Aspose.Cells يسمح لك بإضافة ومعالجة التسميات حتى في المخططات.

الShapeCollection توفر class طريقة تسمىaddLabelInChart ، تُستخدم لإضافة عنصر تحكم تسمية إلى مخطط. فيما يلي قائمة بالمعلمات المستخدمة للطريقة:

• أعلى - الإزاحة الرأسية للملصق من الزاوية اليسرى العليا بوحدات 1/4000 من منطقة الرسم البياني.
• اليسار - الإزاحة الرأسية للملصق من الزاوية اليسرى العليا بوحدات 1/4000 من منطقة الرسم البياني.
• ارتفاع - ارتفاع الملصق بوحدات 1/4000 من منطقة الرسم البياني.
• العرض - عرض الملصق بوحدات 1/4000 من مساحة الرسم البياني.

تقوم الطريقة بإرجاع كائن منمُلصَق الطبقة ، حيثمُلصَقفئة تمثل تسمية في الرسم البياني. لديها بعض الأعضاء المهمين كما هو مفصل أدناه:

• نصتحدد الخاصية سلسلة التسمية التوضيحية الخاصة بالتسمية.
• ملء تحدد الخاصية سمات لون التعبئة.

يوضح المثال التالي كيفية إضافة تسمية إلى المخطط. يستخدم المثال ملف مصمم يحتوي على مخطط بداخله. نستخدم هذا الملف لإدراج تسمية في الرسم البياني.

يوجد أدناه لقطة شاشة لملف المصمم.

مخطط المصمم

يوجد أدناه الرمز الأصلي لإضافة تسمية إلى الرسم البياني. يتم إنشاء الإخراج التالي عند تنفيذ التعليمات البرمجية.

تمت إضافة تسمية في الرسم البياني

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(AddingLabelControl.class) + "charts/";

String filePath = dataDir + "chart.xls";

Workbook workbook = new Workbook(filePath);

Worksheet worksheet = workbook.getWorksheets().get(0);

// Load the chart from source worksheet
Chart chart = worksheet.getCharts().get(0);

Label label = chart.getShapes().addLabelInChart(100, 100, 350, 900);
label.setText("Write Label here");
label.setPlacement(PlacementType.FREE_FLOATING);
label.getFill().getSolidFill().setColor(Color.getChocolate());

// Output the file
workbook.save(dataDir + "ALControl_out.xls");

// Print message
System.out.println("Label added to chart successfully.");

إضافة عنصر تحكم مربع نص إلى التخطيط

تتمثل إحدى طرق تمييز المعلومات المهمة في التقرير في استخدام مربع نص. على سبيل المثال ، أدخل نصًا لتمييز اسم الشركة أو للإشارة إلى المنطقة الجغرافية التي تحقق أعلى مبيعات. الShapeCollection توفر class طريقة تسمىaddTextBoxInChart ، والتي تُستخدم لإضافة عنصر تحكم مربع نص إلى مخطط. فيما يلي قائمة المعلمات المستخدمة للطريقة:

• أعلى - الإزاحة الرأسية لمربع النص من الزاوية اليسرى العليا بوحدات 1/4000 من منطقة الرسم البياني.
• اليسار - الإزاحة الرأسية لمربع النص من الزاوية اليسرى العليا بوحدات 1/4000 من منطقة الرسم البياني.
• ارتفاع ارتفاع مربع النص بوحدات 1/4000 من مساحة الرسم البياني.
• العرض - عرض مربع النص بوحدات 1/4000 من مساحة الرسم البياني.

تقوم الطريقة بإرجاع كائن منمربع الكتابة فئة حيثمربع الكتابةيمثل class مربع نص في الرسم البياني.

يوضح المثال التالي كيفية إضافة مربع نص إلى مخطط. يستخدم المثال ملف المصمم السابق الذي يحتوي على مخطط بداخله. نستخدم هذا الملف لإدراج مربع نص في المخطط لإظهار عنوان المخطط.

يوجد أدناه الرمز الأصلي لإضافة مربع نص إلى المخطط. يتم إنشاء الإخراج التالي عند تنفيذ التعليمات البرمجية.

تمت إضافة مربع نص في الرسم البياني

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(AddingTextBoxControl.class) + "charts/";
String filePath = dataDir + "chart.xls";

// Create a new Workbook.
// Open the existing file.
Workbook workbook = new Workbook(filePath);
Worksheet worksheet = workbook.getWorksheets().get(0);

// Load the chart from source worksheet
Chart chart = worksheet.getCharts().get(0);

// Add a new textbox to the chart.
TextBox txt = chart.getShapes().addTextBoxInChart(100, 100, 850, 2500);
txt.setText("Aspose");
txt.getFont().setItalic(true);
txt.getFont().setSize(20);
txt.getFont().setBold(true);

// Get the filformat of the textbox.
FillFormat fillformat = txt.getFill();
fillformat.setFillType(FillType.SOLID);
fillformat.getSolidFill().setColor(Color.getSilver());

// Get the lineformat type of the textbox.
LineFormat lineformat = txt.getLine();
lineformat.setWeight(2);
lineformat.setDashStyle(MsoLineDashStyle.SOLID);

// Output the file
workbook.save(dataDir + "ATBoxControl_out.xls");

// Print message
System.out.println("TextBox added to chart successfully.");

إضافة صورة إلى المخطط

Aspose.Cells يسمح لك بادراج صور في مخطط. على سبيل المثال ، أضف صورة للتأكيد أو لإعطاء معنى أكبر للمخطط أو محتوياته ، أو قم بإدراج ملف صورة العلامة التجارية.

الShapeCollection توفر class طريقة تسمىaddPictureInChart ، والذي يستخدم لإضافة كائن صورة إلى المخطط. فيما يلي قائمة المعلمات المستخدمة للطريقة:

• أعلى الإزاحة الرأسية للصورة من الزاوية اليسرى العليا بوحدات 1/4000 من منطقة الرسم البياني.
• اليسار الإزاحة الرأسية للصورة من الزاوية اليسرى العليا بوحدات 1/4000 من منطقة الرسم البياني.
• مجرى - كائن تيار يحتوي على بيانات الصورة.
• العرض - مقياس عرض الصورة ، قيمة النسبة المئوية.
• الارتفاع - مقياس ارتفاع الصورة ، قيمة النسبة المئوية.

تقوم الطريقة بإرجاع كائن منصورة فئة حيثصورةفئة تمثل كائن صورة في الرسم البياني.

يوضح المثال التالي كيفية إضافة صورة إلى المخطط. يستخدم المثال ملف المصمم السابق الذي يحتوي على مخطط بداخله. نستخدم هذا الملف لإدراج صورة في الرسم البياني.

يوجد أدناه الرمز الأصلي لإضافة صورة إلى المخطط. يتم إنشاء الإخراج التالي عند تنفيذ التعليمات البرمجية

يتم ادراج صوره في المخطط

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(AddingPictureToChart.class) + "charts/";

String filePath = dataDir + "chart.xls";

FileInputStream stream = new FileInputStream(dataDir + "logo.jpg");

Workbook workbook = new Workbook(filePath);

Worksheet worksheet = workbook.getWorksheets().get(0);

// Load the chart from source worksheet
Chart chart = worksheet.getCharts().get(0);

Picture pic = chart.getShapes().addPictureInChart(50, 50, stream, 40, 40);
LineFormat lineformat = pic.getLine();

lineformat.setFillType(FillType.SOLID);
lineformat.getSolidFill().setColor(Color.getBlue());
lineformat.setDashStyle(MsoLineDashStyle.DASH_DOT_DOT);
// Output the file
workbook.save(dataDir + "APToChart_out.xls");

// Print message
System.out.println("Picture added to chart successfully.");

إضافة خانة اختيار في الرسم البياني

Aspose.Cells يسمح لك بإدراج مربعات الاختيار في ورقة المخطط باستخدامMsoDrawingType تعداد. يوضح المثال التالي إضافة خانة اختيار إلى ورقة المخطط.

تُظهر الصورة التالية ورقة المخطط مع مربع الاختيار في ملف الإخراج.

الملف إلاخراجتم إنشاؤه بواسطة مقتطف الشفرة التالي مرفقًا كمرجع لك.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// directories
String outputDir = Utils.Get_OutputDirectory();

// Instantiating a Workbook object
Workbook workbook = new Workbook();

// Adding a chart to the worksheet
int index = workbook.getWorksheets().add(SheetType.CHART);

Worksheet sheet = workbook.getWorksheets().get(index);
sheet.getCharts().addFloatingChart(ChartType.COLUMN, 0, 0, 1024, 960);
sheet.getCharts().get(0).getNSeries().add("{1,2,3}", false);

// Add checkbox to the chart.
sheet.getCharts().get(0).getShapes().addShapeInChart(MsoDrawingType.CHECK_BOX, PlacementType.MOVE, 400, 400, 1000, 600);
sheet.getCharts().get(0).getShapes().get(0).setText("CheckBox 1");

// Convert chart to image with additional settings
workbook.save(outputDir + "InsertCheckboxInChartSheet_out.xlsx");