تغييرات واجهة برمجة التطبيقات العامة في Aspose.Cells 16.10.0

يصف هذا المستند التغييرات في واجهة برمجة التطبيقات لـ Aspose.Cells من الإصدار 9.0.0 إلى 16.10.0 التي قد تكون مثيرة للاهتمام لمطوري الوحدة / التطبيق. يتضمن ليس فقط الأساليب العامة الجديدة والمحدثة والفئات المضافة والمحذوفة وما إلى ذلك ، ولكن أيضًا وصفًا لأي تغييرات في السلوك وراء الكواليس في Aspose.Cells.

واجهات برمجة التطبيقات الجديدة

دعم لتأثيرات الانعكاس

قدمت Aspose.Cells 16.10.0 فئة ReflectionEffect بالإضافة إلى خاصية Shape.Reflection للتحكم في تأثيرات الانعكاس لكائن Shape. تحتوي فئة ReflectionEffect على الخصائص التالية.

ReflectionEffect.Blur: يحصل/يضع قيمة نصف قطر الطمس بوحدة النقاط.
ReflectionEffect.Direction: يحصل/يعين اتجاه التدرج ألفا بالنسبة إلى الشكل نفسه.
ReflectionEffect.Distance: يحصل/يعين مسافة الانعكاس بوحدة النقاط.
ReflectionEffect.FadeDirection: يحصل/يعين الاتجاه لتحويل الانعكاس.
ReflectionEffect.RotWithShape: يحصل/يعين ما إذا كان الانعكاس يجب أن يدور مع الشكل.
ReflectionEffect.Size: يحصل/يعين الموضع النهائي (على طول التدرج ألفا) لقيمة نهاية ألفا بوحدة النسبة المئوية.
ReflectionEffect.Transparency: يحصل/يعين درجة شفافية الانعكاس البدءية كقيمة من 0.0 (غير شفاف) إلى 1.0 (واضحة).
ReflectionEffect.Type: يحصل/يعين تأثير الانعكاس المحدد مسبقًا.

ها هو سيناريو استخدام بسيط لخاصية Shape.Reflection.

يرجى الاطلاع على المقال المفصل حول العمل مع تأثيرات الانعكاس

 // Load a sample spreadsheet containing a shape

// Alternatively create a new spreadsheet and add a shape

var book = new Workbook("sample.xlsx");

// Access first worksheet from the collection

var sheet = book.Worksheets[0];

// Access first shape from the collection

var shape = sheet.Shapes[0];

// Get the instance of ReflectionEffect from the Shape object

var reflection = shape.Reflection;

// Set its Blur, Size, Transparency and Distance properties

reflection.Blur = 30;

reflection.Size = 90;

reflection.Transparency = 0.5;

reflection.Distance = 80;

// Save the result in XLSX format

book.Save("output.xlsx");

دعم تأثيرات الظل

قد أظهرت Aspose.Cells 16.10.0 خاصية Shape.ShadowEffect إلى جانب صنف ShadowEffect الذي يتيح بالكامل تعيين تأثير الظل على كائن Shape. يحتوي صنف ShadowEffect على الخصائص التالية.

ShadowEffect.Angle: يحصل/يعين زاوية الإضاءة التي تتراوح بين 0 إلى 359.9 درجة.
ShadowEffect.Blur: يحصل/يعين ضبابية الظل التي تتراوح بين 0 إلى 100 نقطة.
ShadowEffect.Color: يحصل/يعين لون الظل.
ShadowEffect.Distance: يحصل/يعين المسافة الظل التي تتراوح بين 0 إلى 200 نقطة.
ShadowEffect.PresetType: يحصل/يعين نوع الظل المحدد مسبقًا للظل.
ShadowEffect.Size: يحصل/يعين حجم الظل الذي يتراوح بين 0 إلى 2.0.سيكون لا معنى له في حالة الظل الداخلي.
ShadowEffect.Transparency: يحصل/يعين درجة شفافية الظل التي تتراوح من 0.0 (غير شفاف) إلى 1.0 (واضحة).

ها هو سيناريو استخدام بسيط للخاصية المذكورة أعلاه.

تحقق من المقال المفصل حول العمل مع تأثيرات الظل

 // Load a sample spreadsheet containing a shape

// Alternatively create a new spreadsheet and add a shape

var book = new Workbook("sample.xlsx");

// Access first worksheet from the collection

var sheet = book.Worksheets[0];

// Access first shape from the collection

var shape = sheet.Shapes[0];

// Get the instance of ShadowEffect from the Shape object

var shadow = shape.ShadowEffect;

// Set its Angle, Blur, Size, Transparency and Distance properties

shadow.Angle = 150;

shadow.Blur = 30;

shadow.Size = 90;

shadow.Transparency = 0.5;

shadow.Distance = 80;

// Save the result in XLSX format

book.Save("output.xlsx");

الدعم لتأثيرات التوهج

أعرضت Aspose.Cells 16.10.0 خاصية Shape.Glow بالإضافة إلى فئة GlowEffect التي تُسمح معًا بتعيين تأثير التوهج لكائن الشكل. تحدد فئة GlowEffect تأثير توهج، حيث يتم إضافة إطار مضبب للون خارج حواف الكائن باستخدام الخصائص التالية.

GlowEffect.Size: يحصل/يقوم بتعيين نصف قطر التوهج بوحدة النقاط.
GlowEffect.Transparency: يحصل/يقوم بتعيين درجة شفافية تأثير التوهج تتراوح بين 0.0 (غير شفاف) و 1.0 (واضح).

إليك سيناريو استخدام بسيط لخاصية Shape.Glow.

تحقق من المقال المفصل حول العمل مع تأثير الضوء المتوهج

 // Load a sample spreadsheet containing a shape

// Alternatively create a new spreadsheet and add a shape

var book = new Workbook("sample.xlsx");

// Access first worksheet from the collection

var sheet = book.Worksheets[0];

// Access first shape from the collection

var shape = sheet.Shapes[0];

// Get the instance of GlowEffect from the Shape object

var glow = shape.Glow;

// Set its Size & Transparency properties

glow.Size = 90;

glow.Transparency = 0.5;

// Save the result in XLSX format

book.Save("output.xlsx");

الدعم لتنسيق ثلاثي الأبعاد

أعرضت Aspose.Cells 16.10.0 خاصية Shape.ThreeDFormat بالإضافة إلى فئة ThreeDFormat التي يمكن استخدامها معًا للتحكم في تنسيق الأبعاد ثلاثية الشكل. تُمثل فئة ThreeDFormat تنسيق الأبعاد الثلاثية للشكل وتحتوي على الخصائص التالية.

ThreeDFormat.BottomBevelHeight: يحصل/يقوم بتعيين ارتفاع الحافة السفلية أو مدى تطبيقها على الشكل، بوحدة النقاط.
ThreeDFormat.BottomBevelType: يحصل/يقوم بتعيين نوع الحافة السفلية أو مدى تطبيقها على الشكل، بوحدة النقاط.
ThreeDFormat.BottomBevelWidth: يحصل/يقوم بتعيين عرض الحافة السفلية أو مدى تطبيقها على الشكل، بوحدة النقاط.
ThreeDFormat.ContourColor: يحصل/يقوم بتعيين لون التحديد على الشكل.
ThreeDFormat.ContourWidth: يحصل/يقوم بتعيين عرض التحديد على الشكل، بوحدة النقاط.
ThreeDFormat.ExtrusionColor: يحصل على لون الإرتفاع على الشكل.
ThreeDFormat.ExtrusionHeight: يحصل/يقوم بتعيين ارتفاع الإرتفاع المطبق على الشكل، بوحدة النقاط.
ThreeDFormat.LightAngle: يحصل/يقوم بتعيين زاوية أضواء الإرتفاع.
ThreeDFormat.Lighting: يحصل/يقوم بتعيين نوع الجو الخفيف.
ThreeDFormat.LightingDirection: يحصل/ يحدد الاتجاه الذي يتوجه منه معدات الإضاءة بالنسبة للمشهد.
ThreeDFormat.Material: يمثل المواد المُعينة التي تجمع مع خصائص الإضاءة لإعطاء المظهر والشعور النهائي للشكل.
ThreeDFormat.Perspective: يحصل/ يحدد الزاوية التي يمكن من خلالها رؤية كائن ThreeDFormat.
ThreeDFormat.PresetCameraType: يحصل/ يحدد كاميرا الاستخراج المُعينة.
ThreeDFormat.RotationX: يحصل/ يحدد دوران الشكل المنتفخ حول محور الإكس بوحدة من الدرجات.
ThreeDFormat.RotationY: يحصل/ يحدد دوران الشكل المنتفخ حول محور الواي بوحدة من الدرجات.
ThreeDFormat.RotationZ: يحصل/ يحدد دوران الشكل المنتفخ حول محور الزد بوحدة من الدرجات.
ThreeDFormat.TopBevelHeight: يحصل/ يحدد ارتفاع الحافة العلوية أو مدى تطبيقها في الشكل بوحدة من النقاط.
ThreeDFormat.TopBevelType: يحصل/ يحدد نوع الحافة العلوية أو مدى تطبيقها في الشكل بوحدة من النقاط.
ThreeDFormat.TopBevelWidth: يحصل/ يحدد عرض الحافة العلوية أو مدى تطبيقها في الشكل بوحدة من النقاط.
ThreeDFormat.Z: يُعرِّف المسافة من الأرض للشكل ثلاثي الأبعاد.

فيما يلي سيناريو الاستخدام البسيط لخاصية Shape.ThreeDFormat.

تحقق من المقال المفصل عن العمل مع تنسيقات ثلاثية الأبعاد

 // Load a sample spreadsheet containing a shape

// Alternatively create a new spreadsheet and add a shape

var book = new Workbook("sample.xlsx");

// Access first worksheet from the collection

var sheet = book.Worksheets[0];

// Access first shape from the collection

var shape = sheet.Shapes[0];

// Get the instance of ThreeDFormat from the Shape object

var threeD = shape.ThreeDFormat;

// Set its ContourWidth & ExtrusionHeight properties

threeD.ContourWidth = 15;

threeD.ExtrusionHeight = 30;

// Save the result in XLSX format

book.Save("output.xlsx");

دعم لأنماط WordArt في نص الشكل

كشفت Aspose.Cells 16.10.0 عن أساليب FontSettingCollection.SetWordArtStyle & FontSetting.SetWordArtStyle لضبط أسلوب WordArt المُعين مسبقًا لنص الشكل.

فيما يلي سيناريو استخدام بسيط للطرق المذكورة أعلاه.

تحقق من المقال المفصل عن العمل مع أنماط WordArt

 // Create workbook object

var book = new Workbook();

// Access first worksheet from the collection

var sheet = book.Worksheets[0];

// Create a TextBox with some text

var textBox = sheet.Shapes.AddTextBox(0, 0, 0, 0, 100, 700);

textBox.Text = "Aspose File Format APIs";

textBox.Font.Size = 44;

// Set preset WordArt style to the text of the shape

FontSetting fntSetting = textBox.GetCharacters()[0] as FontSetting;

fntSetting.SetWordArtStyle(PresetWordArtStyle.WordArtStyle3);

دعم لأساليب WordArt المضمنة

أتاح Aspose.Cells 16.10.0 طريقة إضافة الكلمات الفنية (WordArt) مع قائمة تمهيدية لأسلوب WordArtPreserenumeration بهدف دعم إضافة كائنات WordArt التي تم تحديدها مسبقًا منذ إصدار Excel 2007.

إليك سيناريو استخدام بسيط لطريقة إضافة الكلمات الفنية (WordArt) في مجموعة الأشكال.

تحقق من المقال المفصل عن إضافة WordArt بأنماط مدمجة

 // Create an instance of Workbook

var book = new Workbook();

// Access first worksheet from the collection

var sheet = book.Worksheets[0];

// Access ShapeCollection of first worksheet

var shapes = sheet.Shapes;

// Add WordArt with built-in styles

shapes.AddWordArt(PresetWordArtStyle.WordArtStyle1, "Aspose File Format APIs", 00, 0, 0, 0, 100, 800);

shapes.AddWordArt(PresetWordArtStyle.WordArtStyle2, "Aspose File Format APIs", 10, 0, 0, 0, 100, 800);

shapes.AddWordArt(PresetWordArtStyle.WordArtStyle3, "Aspose File Format APIs", 20, 0, 0, 0, 100, 800);

shapes.AddWordArt(PresetWordArtStyle.WordArtStyle4, "Aspose File Format APIs", 30, 0, 0, 0, 100, 800);

shapes.AddWordArt(PresetWordArtStyle.WordArtStyle5, "Aspose File Format APIs", 40, 0, 0, 0, 100, 800);

// Save the result in XLSX format

book.Save("output.xlsx");

تمت إضافة طريقة XmlMapCollection.Add

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

تحقق من المقال المفصل حول إضافة خريطة XML إلى جدول بيانات

 // Create an instance of Workbook

var book = new Workbook();

// Add xml map from the sample.xml to the workbook

book.Worksheets.XmlMaps.Add("sample.xml");

تمت إضافة طريقة Cells.LinkToXmlMap

لقد قامت Aspose.Cells الآن بعرض طريقة Cells.LinkToXmlMap لربط الخلايا بعناصر خريطة XML.

إليك سيناريو استخدام بسيط لطريقة Cells.LinkToXmlMap.

تحقق من المقال المفصل حول ربط الخلايا بعناصر خريطة XML

 // Load a sample spreadsheet in an instance of Workbook

var book = new Workbook("sample.xlsx");

// Access the XML Map from the spreadsheet

var map = book.Worksheets.XmlMaps[0];

// Access first worksheet from the collection

var sheet = book.Worksheets[0];

// Map FIELD1 and FIELD2 to cell A1 and B2

sheet.Cells.LinkToXmlMap(map.Name, 0, 0, "/root/row/FIELD1");

sheet.Cells.LinkToXmlMap(map.Name, 1, 1, "/root/row/FIELD2");

// Map FIELD4 and FIELD5 to cell C3 and D4

sheet.Cells.LinkToXmlMap(map.Name, 2, 2, "/root/row/FIELD4");

sheet.Cells.LinkToXmlMap(map.Name, 3, 3, "/root/row/FIELD5");

// Map FIELD7 and FIELD8 to cell E5 and F6

sheet.Cells.LinkToXmlMap(map.Name, 4, 4, "/root/row/FIELD7");

sheet.Cells.LinkToXmlMap(map.Name, 5, 5, "/root/row/FIELD8");

تمت إضافة خاصية ListColumn.Formula

أتاح Aspose.Cells 16.10.0 خاصية ListColumn.Formula بهدف نقل الصيغة تلقائيًا إلى الصفوف المدخلة حديثًا.

إليك سيناريو استخدام بسيط لخاصية ListColumn.Formula.

تحقق من المقال المفصل حول نشر الصيغة تلقائيًا في كائن القائمة

 // Create an instance of Workbook

var book = new Workbook();

// Access first worksheet from the collection

var sheet = book.Worksheets[0];

// Add column headings in cell A1 and B1

sheet.Cells[0, 0].PutValue("Column A");

sheet.Cells[0, 1].PutValue("Column B");

// Add list object, set its name and style

var listObject = sheet.ListObjects[sheet.ListObjects.Add(0, 0, 1, sheet.Cells.MaxColumn, true)];

listObject.TableStyleType = TableStyleType.TableStyleMedium2;

listObject.DisplayName = "Table";

// Set the formula of second column so that it could automatically propagate to new rows while entering data

listObject.ListColumns[1].Formula = "=[Column A] + 1";

// Save the result in XLSX format

book.Save("output.xlsx");

دعم حساب الوظائف المخصصة باستخدام GridWeb

لقد عرض Aspose.Cells.GridWeb 16.10.0 خاصية GridWeb.CustomCalculationEngine بالإضافة إلى فئة GridAbstractCalculationEngine والتي تتيح معًا تحديد وحساب الوظائف المخصصة من داخل مكون GridWeb.

إليك سيناريو استخدام بسيط للواجهات البرمجية المذكورة أعلاه.

تحقق من المقال المفصل حول حساب الوظائف المخصصة باستخدام GridWeb

 private class GridWebCustomCalculationEngine : GridAbstractCalculationEngine

{

    public override void Calculate(GridCalculationData data)

    {

        //  Calculate MYTESTFUNC() with your own logic.

        //For example, you can multiply MYTESTFUNC() parameter with 2 so

        // MYTESTFUNC(3.0) will return 6

        // MYTESTFUNC(4.0) will return 8

        // MYTESTFUNC(5.0) will return 10

        if ("MYTESTFUNC".Equals(data.FunctionName.ToUpper()))

        {

            data.CalculatedValue = (decimal)(2.0 * (double)data.GetParamValue(0));

        }

    }

}


if (Page.IsPostBack == false && GridWeb1.IsPostBack == false)

{

    // Assign your own custom calculation engine to GridWeb

    GridWeb1.CustomCalculationEngine = new GridWebCustomCalculationEngine();

    // Access the active worksheet and add your custom function in cell B3

    GridWorksheet sheet = GridWeb1.ActiveSheet;

    GridCell cell = sheet.Cells["B3"];

    cell.Formula = "=MYTESTFUNC(9.0)";

    // Calculate the GridWeb formula

    GridWeb1.CalculateFormula();

}

تغييرات API العامة في Aspose.Cells 9.0.0 تغييرات واجهة برمجة التطبيقات العامة في Aspose.Cells 16.11.0