API عام تغييرات في Aspose.Cells 17.1.0
تمت إضافة واجهات برمجة التطبيقات
دعم مخططات Excel 2016
أضافت واجهات برمجة تطبيقات Aspose.Cells دعمًا لبعض مخططات Excel 2016 من خلال تحسين تعداد ChartType. تمت إضافة الحقول الجديدة التالية بإصدار Aspose.Cells 17.1.0.
- ChartType.BoxWhisker: تم وضع السلسلة كمربع وشعر.
- ChartType.Funnel: تم وضع السلسلة على شكل قمع.
- ChartType.ParetoLine: تم وضع السلسلة كخطوط باريتو.
- ChartType.Sunburst: تم وضع السلسلة على شكل انفجار شمس.
- ChartType.Treemap: تم تخطيط السلسلة كخريطة شبكية.
- ChartType.Waterfall: تم وضع السلسلة على شكل شلال.
- ChartType.Histogram: تم تخطيط السلسلة كرسم بياني.
تمت إضافة أداة ضبط لخاصية LoadFilter.LoadDataFilterOptions
قام Aspose.Cells 17.1.0 بإضافة أداة ضبط للخاصية LoadFilter.LoadDataFilterOptions لاستبدال متغير نسخة m_LoadDataFilterOptions. قد يقوم المستخدمون بتغيير الخاصية LoadDataFilterOptions في التطبيق الخاص بهم لفئة LoadFilter لتغيير سلوك تحميل ملفات القوالب.
هنا سيناريو استخدام بسيط.
C#
class CustomFilter : Aspose.Cells.LoadFilter
{
public override void StartSheet(Worksheet sheet)
{
if (sheet.Name == "Sheet1")
{
// Load everything
this.LoadDataFilterOptions = LoadDataFilterOptions.All;
}
else
{
// Load nothing
this.LoadDataFilterOptions = LoadDataFilterOptions.None;
}
}
}
تمت إضافة خاصية CellsHelper.SignificantDigits
كشف Aspose.Cells 17.1.0 خاصية SignificantDigits من فئة CellsHelper والتي تسمح بالحصول على أو تعيين عدد الأرقام المعنوية للقيم الرقمية في جدول بيانات. القيمة الافتراضية للخاصية CellsHelper.SignificantDigits هي 17 في حين أنها قابلة للتطبيق فقط إذا كان لابد من تخزين النتيجة في تنسيق ملف XLSX.
فيما يلي سيناريو بسيط لتوضيح استخدام خاصية CellsHelper.SignificantDigits.
C#
// Specify the number of significant digits
CellsHelper.SignificantDigits = 15;
تمت إضافة خاصية GlowEffect.Color
أضاف Aspose.Cells 17.1.0 خاصية GlowEffect.Color التي يمكن استخدامها لاسترداد لون تأثير التوهج.
يستخدم المقتطف التالي خاصية GlowEffect.Color.
C#
// Read the source excel file
var book = new Workbook(dir + "sample.xlsx");
// Access first worksheet
var sheet = book.Worksheets[0];
// Access the first shape
var shape = sheet.Shapes[0];
// Read the glow effect color
var glow = shape.Glow;
var color = glow.Color;
تمت إضافة خصائص PageSetup.PaperWidth و PaperHeight
قام Aspose.Cells 17.1.0 بعرض خصائص PaperWidth و PaperHeight لفئة PageSetup. تعد خصائص PageSetup.PaperWidth & PageSetup.PaperHeight من النوع المزدوج الذي يمثل عرض الورق وارتفاعه بوحدة البوصة مع مراعاة اتجاه الصفحة.
تمت إضافة خاصية WorkbookSettings.CheckCustomNumberFormat
قام Aspose.Cells 17.1.0 بإضافة الخاصية CheckCustomNumberFormat إلى فئة WorkbookSettings. يعتبر CheckCustomNumberFormat مفيدًا في التحقق مما إذا كانت الخاصية Style.Custom قد تم تعيينها بشكل صحيح أم لا. في حالة تعيين الخاصية Style.Custom بشكل غير صحيح ، أي ؛ القيمة لا تتوافق مع النمط الصالح ، فإن واجهات برمجة التطبيقات Aspose.Cells ستلقي CellsException بالرسالة المناسبة.
C#
// Create an instance of Workbook
var book = new Workbook();
// Set CheckCustomNumberFormat property to true
book.Settings.CheckCustomNumberFormat = true;
// Access first worksheet
var sheet = book.Worksheets[0];
// Access a cell
var cell = sheet.Cells["B5"];
// Insert a value to the cell
cell.PutValue(2347);
// Access cell's style
Style style = cell.GetStyle();
// Set Custom property to an invalid pattern
style.Custom = "ggg @ fff";
// Set the modified style to the cell
cell.SetStyle(style);
تمت إضافة DisplayUnitType. حقل النسبة المئوية
قام Aspose.Cells 17.1.0 أيضًا بعرض حقل النسبة المئوية لتعداد DisplayUnitType. يشير الحقل DisplayUnitType.Percentage إلى أن القيم على الرسم البياني يجب قسمة 0.01.
إزالة واجهات برمجة التطبيقات
تمت إزالة متغير المثيل m_LoadDataFilterOptions
قام هذا الإصدار بإزالة متغير مثيل m_LoadDataFilterOptions. يُنصح باستخدام الخاصية LoadFilter.LoadDataFilterOptions بدلاً من ذلك.