تغييرات الواجهة البرمجية العامة في Aspose.Cells 8.5.2
واجهات برمجة التطبيقات الجديدة
عرض الورقة العمل إلى سياق رسومي
تم تعريف إصدار Aspose.Cells for .NET API الحالي بطرح اثنين من Overloads الجديدة لطريقة SheetRender.ToImage التي تسمح الآن بقبول مثيل من فئة System.Drawing.Graphics لالرسم في سياق الرسم. تواقيع الأساليب الجديدة التي تمت إضافتها هي كالتالي.
- SheetRender.ToImage(int pageIndex, Graphics g, float x, float y)
- SheetRender.ToImage(int pageIndex, Graphics g, float x, float y, float width, float height)
فيما يلي سيناريو الاستخدام البسيط.
C#
//Create workbook object from source file
Workbook workbook = new Workbook(filePath);
//Access first worksheet
Worksheet worksheet = workbook.Worksheets[0];
//Create empty Bitmap
Bitmap bmp = new Bitmap(800, 800);
//Create Graphics Context
Graphics g = Graphics.FromImage(bmp);
g.Clear(Color.Blue);
//Set one page per sheet to true in image or print options
ImageOrPrintOptions opts = new ImageOrPrintOptions();
opts.OnePagePerSheet = true;
//Render worksheet to graphics context
SheetRender sr = new SheetRender(worksheet, opts);
sr.ToImage(0, g, 0, 0);
//Save the graphics context image in Png format
bmp.Save("test.png", ImageFormat.Png);
أضيفت طريقة PivotTable.GetCellByDisplayName
ضاف Aspose.Cells for .NET 8.5.2 طريقة PivotTable.GetCellByDisplayName التي يمكن استخدامها لاسترجاع كائن الخلية باسم PivotField. يمكن أن تكون هذه الطريقة مفيدة في السيناريوهات حيث ترغب في تسليط الضوء على أو تنسيق رأس PivotField.
فيما يلي سيناريو الاستخدام البسيط.
C#
//Create workbook object from source excel file
Workbook workbook = new Workbook(filePath);
//Access first worksheet
Worksheet worksheet = workbook.Worksheets[0];
//Access first pivot table inside the worksheet
PivotTable pivotTable = worksheet.PivotTables[0];
//Access cell by display name of 2nd data field of the pivot table
Cell cell = pivotTable.GetCellByDisplayName(pivotTable.DataFields[1].DisplayName);
//Access cell style and set its fill color and font color
Style style = cell.GetStyle();
style.ForegroundColor = Color.LightBlue;
style.Font.Color = Color.Black;
//Set the style of the cell
pivotTable.Format(cell.Row, cell.Column, style);
//Save workbook
workbook.Save("output.xlsx");
تمت إضافة خاصية SaveOptions.MergeAreas
ضاف Aspose.Cells for .NET 8.5.2 خاصية SaveOptions.MergeAreas التي يمكن أن تقبل قيمة من نوع Boolean. القيمة الافتراضية هي false، ومع ذلك، إذا تم ضبطها على true، فإن Aspose.Cells for .NET API يحاول دمج CellArea الفردية قبل حفظ الملف.
أضيفت خاصية Shape.Geometry.ShapeAdjustValues
مع إصدار v8.5.2، تم تعريف Aspose.Cells API بخاصية Shape.Geometry.ShapeAdjustValues التي يمكن استخدامها لإجراء تغييرات على نقاط التعديل لأشكال مختلفة.
على سبيل المثال،
- لديك مستطيل مستدير له تعديل لتغيير القوس
- لديك مثلث له تعديل لتغيير موقع النقطة
- لديك متوازي الأضلاع له تعديل لتغيير عرض الجزء العلوي
- لديك سهام له تعديلين لتغيير شكل الرأس والذيل
فيما يلي سيناريو الاستخدام الأبسط.
C#
//Create workbook object from source excel file
Workbook workbook = new Workbook(filePath);
//Access first worksheet
Worksheet worksheet = workbook.Worksheets[0];
//Access first three shapes of the worksheet
Shape shape1 = worksheet.Shapes[0];
Shape shape2 = worksheet.Shapes[1];
Shape shape3 = worksheet.Shapes[2];
//Change the adjustment values of the shapes
shape1.Geometry.ShapeAdjustValues[0].Value = 0.5d;
shape2.Geometry.ShapeAdjustValues[0].Value = 0.8d;
shape3.Geometry.ShapeAdjustValues[0].Value = 0.5d;
//Save the workbook
workbook.Save("output.xls);
تمت إضافة تعداد Field ConsolidationFunction.DistinctCount
قام Aspose.Cells for .NET 8.5.2 بتعريض حقل ConsolidationFunction.DistinctCount الذي يمكن استخدامه لـ تطبيق وظيفة تجميع العدد المميز على DataField من PivotTable.
تحسين معالجة الأحداث لـ GridDesktop
تم تعريض 4 أحداث جديدة في الإصدار الحالي من Aspose.Cells.GridDesktop. يُشغّل 2 من هذه الأحداث في حالات مختلفة من تحميل ملفات جداول البيانات في GridDesktop بينما تُشغّل 2 أخرى عند حساب الصيغ.
تم سرد الأحداث على النحو التالي.
- GridDesktop.BeforeLoadFile
- GridDesktop.FinishLoadFile
- GridDesktop.BeforeCalculate
- GridDesktop.FinishCalculate