التحكم في الرسوم البيانية

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

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

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

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

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

  • تحدد Text السمة سلسلة التسمية.
  • تحدد السمة Fill سمات لون التعبئة.

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

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

مخطط التصميم

todo:image_alt_text

فيما يلي الرمز الأصلي لإضافة تسمية إلى المخطط. يتم توليد النتائج التالية عند تنفيذ الرمز.

تمت إضافة تسمية في المخطط

todo:image_alt_text

// 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 طريقة تسمى addTextBoxInChart ، التي تُستخدم لإضافة عنصر تحكم مربع نص إلى رسم بياني. وفيما يلي قائمة المعلمات المستخدمة للطريقة:

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

تُرجع الطريقة كائنًا من فئة TextBox حيث تمثل الفئة TextBox مربع نص في المخطط.

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

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

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

todo:image_alt_text

// 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 طريقة تسمى addPictureInChart ، والتي تُستخدم لإضافة كائن صورة إلى الرسم البياني. وفيما يلي قائمة المعلمات المستخدمة للطريقة:

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

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

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

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

يتم إدراج صورة في الرسم البياني

todo:image_alt_text

// 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. يوضح المثال التالي إضافة مربع اختيار إلى ورقة الرسم البياني.

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

todo:image_alt_text

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

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