إدارة جداول العروض التقديمية في .NET

الجدول في PowerPoint طريقة فعّالة لعرض وتوضيح المعلومات. المعلومات في شبكة من الخلايا (مرتبة في صفوف وأعمدة) واضحة وسهلة الفهم.

توفر Aspose.Slides الفئة Table ، الواجهة ITable ، الفئة Cell ، الواجهة ICell ، وأنواع أخرى للسماح بإنشاء وتحديث وإدارة الجداول في جميع أنواع العروض التقديمية.

إنشاء جدول من الصفر

  1. إنشاء كائن من الفئة Presentation .
  2. الحصول على مرجع الشريحة عبر الفهرس الخاص بها.
  3. تحديد مصفوفة columnWidth.
  4. تحديد مصفوفة rowHeight.
  5. إضافة كائن ITable إلى الشريحة عبر طريقة AddTable .
  6. التنقل عبر كل ICell لتطبيق التنسيق على الحدود العلوية والسفلية واليمين واليسار.
  7. دمج الخليتين الأوليين من الصف الأول للجدول.
  8. الوصول إلى TextFrame الخاص بـ ICell .
  9. إضافة بعض النص إلى الـ TextFrame .
  10. حفظ العرض التقديمي المعدّل.

يعرض لك هذا الكود C# كيفية إنشاء جدول في عرض تقديمي:

// يقوم بإنشاء كائن من فئة Presentation التي تمثل ملف PPTX
Presentation pres = new Presentation();

// الوصول إلى الشريحة الأولى
ISlide sld = pres.Slides[0];

// يحدد الأعمدة بعرضها والصفوف بطولها
double[] dblCols = { 50, 50, 50 };
double[] dblRows = { 50, 30, 30, 30, 30 };

// يضيف شكل جدول إلى الشريحة
ITable tbl = sld.Shapes.AddTable(100, 50, dblCols, dblRows);

// يضبط تنسيق الحدود لكل خلية
for (int row = 0; row < tbl.Rows.Count; row++)
{
	for (int cell = 0; cell < tbl.Rows[row].Count; cell++)
	{
		tbl.Rows[row][cell].CellFormat.BorderTop.FillFormat.FillType = FillType.Solid;
		tbl.Rows[row][cell].CellFormat.BorderTop.FillFormat.SolidFillColor.Color = Color.Red;
		tbl.Rows[row][cell].CellFormat.BorderTop.Width = 5;

		tbl.Rows[row][cell].CellFormat.BorderBottom.FillFormat.FillType = (FillType.Solid);
		tbl.Rows[row][cell].CellFormat.BorderBottom.FillFormat.SolidFillColor.Color= Color.Red;
		tbl.Rows[row][cell].CellFormat.BorderBottom.Width =5;

		tbl.Rows[row][cell].CellFormat.BorderLeft.FillFormat.FillType = FillType.Solid;
		tbl.Rows[row][cell].CellFormat.BorderLeft.FillFormat.SolidFillColor.Color =Color.Red;
		tbl.Rows[row][cell].CellFormat.BorderLeft.Width = 5;

		tbl.Rows[row][cell].CellFormat.BorderRight.FillFormat.FillType = FillType.Solid;
		tbl.Rows[row][cell].CellFormat.BorderRight.FillFormat.SolidFillColor.Color = Color.Red;
		tbl.Rows[row][cell].CellFormat.BorderRight.Width = 5;
	}
}
// يدمج الخلايا 1 و 2 من الصف الأول
tbl.MergeCells(tbl.Rows[0][0], tbl.Rows[1][1], false);

// يضيف بعض النص إلى الخلية المدمجة
tbl.Rows[0][0].TextFrame.Text = "Merged Cells";

// يحفظ العرض التقديمي إلى القرص
pres.Save("table.pptx", SaveFormat.Pptx);

الترقيم في جدول قياسي

في جدول قياسي، ترقيم الخلايا بسيط وبدءًا من الصفر. الخلية الأولى في الجدول تحمل الفهرس 0,0 (العمود 0، الصف 0).

على سبيل المثال، تُرقم خلايا جدول يحتوي على 4 أعمدة و4 صفوف بهذه الطريقة:

(0, 0) (1, 0) (2, 0) (3, 0)
(0, 1) (1, 1) (2, 1) (3, 1)
(0, 2) (1, 2) (2, 2) (3, 2)
(0, 3) (1, 3) (2, 3) (3, 3)

يعرض لك هذا الكود C# كيفية تحديد الترقيم للخلايا في جدول:

// ينشئ كائنًا من فئة Presentation يمثل ملف PPTX
using (Presentation pres = new Presentation())
{

    // الوصول إلى الشريحة الأولى
    ISlide sld = pres.Slides[0];

    // تحديد الأعمدة بعرضها والصفوف بارتفاعها
    double[] dblCols = { 70, 70, 70, 70 };
    double[] dblRows = { 70, 70, 70, 70 };

    // إضافة شكل جدول إلى الشريحة
    ITable tbl = sld.Shapes.AddTable(100, 50, dblCols, dblRows);

    // ضبط تنسيق الحدود لكل خلية
    foreach (IRow row in tbl.Rows)
    {
        foreach (ICell cell in row)
        {
			cell.CellFormat.BorderTop.FillFormat.FillType = FillType.Solid;
			cell.CellFormat.BorderTop.FillFormat.SolidFillColor.Color = Color.Red;
			cell.CellFormat.BorderTop.Width = 5;

			cell.CellFormat.BorderBottom.FillFormat.FillType = FillType.Solid;
			cell.CellFormat.BorderBottom.FillFormat.SolidFillColor.Color = Color.Red;
			cell.CellFormat.BorderBottom.Width = 5;

			cell.CellFormat.BorderLeft.FillFormat.FillType = FillType.Solid;
			cell.CellFormat.BorderLeft.FillFormat.SolidFillColor.Color = Color.Red;
			cell.CellFormat.BorderLeft.Width = 5;

			cell.CellFormat.BorderRight.FillFormat.FillType = FillType.Solid;
			cell.CellFormat.BorderRight.FillFormat.SolidFillColor.Color = Color.Red;
			cell.CellFormat.BorderRight.Width = 5;
        }
    }

    // حفظ العرض التقديمي إلى القرص
    pres.Save("StandardTables_out.pptx", SaveFormat.Pptx);
}

الوصول إلى جدول موجود

  1. إنشاء نسخة من الفئة Presentation .

  2. الحصول على مرجع للشرائح التي تحتوي على الجدول عبر فهرسها.

  3. إنشاء كائن ITable وتعيينه إلى null.

  4. التنقل عبر جميع كائنات IShape حتى يتم العثور على الجدول.

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

  5. استخدم كائن ITable للعمل مع الجدول. في المثال أدناه، أضفنا صفًا جديدًا إلى الجدول.

  6. حفظ العرض التقديمي المعدّل.

يعرض لك هذا الكود C# كيفية الوصول إلى جدول موجود والعمل معه:

// ينشئ مثيلًا لفئة Presentation التي تمثل ملف PPTX
using (Presentation pres = new Presentation("UpdateExistingTable.pptx"))
{

    // يصل إلى الشريحة الأولى
    ISlide sld = pres.Slides[0];

    // يهيئ TableEx بقيمة null
    ITable tbl = null;

    // يتنقل عبر الأشكال ويعيّن مرجعًا للجدول المكتشف
    foreach (IShape shp in sld.Shapes)
        if (shp is ITable)
            tbl = (ITable)shp;

    // يحدد النص للعمود الأول من الصف الثاني
    tbl[0, 1].TextFrame.Text = "New";

    // يحفظ العرض التقديمي المعدّل إلى القرص
    pres.Save("table1_out.pptx", Aspose.Slides.Export.SaveFormat.Pptx);
}

محاذاة النص في جدول

  1. إنشاء نسخة من الفئة Presentation .
  2. الحصول على مرجع الشريحة عبر الفهرس الخاص بها.
  3. إضافة كائن ITable إلى الشريحة.
  4. الوصول إلى كائن ITextFrame من الجدول.
  5. الوصول إلى الـ IParagraph الخاص بـ ITextFrame .
  6. محاذاة النص عموديًا.
  7. حفظ العرض التقديمي المعدّل.

يعرض لك هذا الكود C# كيفية محاذاة النص في جدول:

// ينشئ مثيلًا من فئة Presentation
Presentation presentation = new Presentation();

// يحصل على الشريحة الأولى
ISlide slide = presentation.Slides[0];

// يحدد الأعمدة بعرضها والصفوف بارتفاعها
double[] dblCols = { 120, 120, 120, 120 };
double[] dblRows = { 100, 100, 100, 100 };

// يضيف شكل الجدول إلى الشريحة
ITable tbl = slide.Shapes.AddTable(100, 50, dblCols, dblRows);
tbl[1, 0].TextFrame.Text = "10";
tbl[2, 0].TextFrame.Text = "20";
tbl[3, 0].TextFrame.Text = "30";

// يصل إلى إطار النص
ITextFrame txtFrame = tbl[0, 0].TextFrame;

// ينشئ كائن الفقرة لإطار النص
IParagraph paragraph = txtFrame.Paragraphs[0];

// ينشئ كائن الجزء للفقرة
IPortion portion = paragraph.Portions[0];
portion.Text = "Text here";
portion.PortionFormat.FillFormat.FillType = FillType.Solid;
portion.PortionFormat.FillFormat.SolidFillColor.Color = Color.Black;

// يضبط محاذاة النص عموديًا
ICell cell = tbl[0, 0];
cell.TextAnchorType = TextAnchorType.Center;
cell.TextVerticalType = TextVerticalType.Vertical270;

// يحفظ العرض التقديمي إلى القرص
presentation.Save("Vertical_Align_Text_out.pptx", SaveFormat.Pptx);

تعيين تنسيق النص على مستوى الجدول

  1. إنشاء نسخة من الفئة Presentation .
  2. الحصول على مرجع الشريحة عبر الفهرس الخاص بها.
  3. الوصول إلى كائن ITable من الشريحة.
  4. تعيين FontHeight للنص.
  5. تعيين Alignment وMarginRight .
  6. تعيين TextVerticalType .
  7. حفظ العرض التقديمي المعدّل.

يعرض لك هذا الكود C# كيفية تطبيق خيارات التنسيق المفضلة على النص في جدول:

// ينشئ مثيلًا من فئة Presentation
Presentation presentation = new Presentation();
ISlide slide = presentation.Slides[0];

ITable someTable = presentation.Slides[0].Shapes[0] as ITable; // لنفترض أن الشكل الأول في الشريحة الأولى هو جدول

// يضبط ارتفاع الخط لخلايا الجدول
PortionFormat portionFormat = new PortionFormat();
portionFormat.FontHeight = 25;
someTable.SetTextFormat(portionFormat);

// يضبط محاذاة النص والهوامش اليمنى لخلايا الجدول في استدعاء واحد
ParagraphFormat paragraphFormat = new ParagraphFormat();
paragraphFormat.Alignment = TextAlignment.Right;
paragraphFormat.MarginRight = 20;
someTable.SetTextFormat(paragraphFormat);

// يضبط نوع النص العمودي لخلايا الجدول
TextFrameFormat textFrameFormat = new TextFrameFormat();
textFrameFormat.TextVerticalType = TextVerticalType.Vertical;
someTable.SetTextFormat(textFrameFormat);


presentation.Save("result.pptx", Aspose.Slides.Export.SaveFormat.Pptx);

الحصول على خصائص نمط الجدول

تتيح لك Aspose.Slides استرداد خصائص النمط لجدول بحيث يمكنك استخدام هذه التفاصيل لجدول آخر أو في مكان آخر. يعرض لك هذا الكود C# كيفية الحصول على خصائص النمط من نمط جدول مسبق:

using (Presentation pres = new Presentation())
{
    ITable table = pres.Slides[0].Shapes.AddTable(10, 10, new double[] { 100, 150 }, new double[] { 5, 5, 5 });
    table.StylePreset = TableStylePreset.DarkStyle1; // تغيير نمط الإعداد المسبق الافتراضي 
    pres.Save("table.pptx", SaveFormat.Pptx);
}

قفل نسبة الأبعاد لجدول

نسبة الأبعاد لشكل هندسي هي نسبة أحجامه في الأبعاد المختلفة. توفر Aspose.Slides الخاصية AspectRatioLocked للسماح لك بقفل إعداد نسبة الأبعاد للجداول والأشكال الأخرى.

يعرض لك هذا الكود C# كيفية قفل نسبة الأبعاد لجدول:

using (Presentation pres = new Presentation("pres.pptx"))
{
    ITable table = (ITable)pres.Slides[0].Shapes[0];
    Console.WriteLine($"Lock aspect ratio set: {table.ShapeLock.AspectRatioLocked}");

    table.ShapeLock.AspectRatioLocked = !table.ShapeLock.AspectRatioLocked; // عكس

    Console.WriteLine($"Lock aspect ratio set: {table.ShapeLock.AspectRatioLocked}");

    pres.Save("pres-out.pptx", SaveFormat.Pptx);
}

الأسئلة المتكررة

هل يمكنني تمكين اتجاه القراءة من اليمين إلى اليسار (RTL) لجدول كامل والنص داخل خلاياه؟

نعم. exposing الجدول خاصية RightToLeft ، والفقرات لديها ParagraphFormat.RightToLeft. استخدامهما معًا يضمن الترتيب والعرض الصحيحين RTL داخل الخلايا.

كيف يمكنني منع المستخدمين من تحريك أو تعديل حجم جدول في الملف النهائي؟

استخدم shape locks لتعطيل التحريك، تعديل الحجم، التحديد، إلخ. تُطبق هذه الأقفال على الجداول أيضًا.

هل يدعم إدراج صورة داخل خلية كخلفية؟

نعم. يمكنك تعيين picture fill لخلية؛ ستغطي الصورة مساحة الخلية وفقًا للوضع المختار (تمديد أو تجانب).

إدارة الصفوف والأعمدة في جداول PowerPoint في .NET