فئة Table

Table class

يمثل جدولًا.

public sealed class Table : CompositeNode<TableRow>, IOutlineElementChildNode, ITaggable

المُنشئات

الاسمالوصف
Table()البناء الافتراضي.

الخصائص

الاسمالوصف
Columns { get; }يحصل على أعمدة الجدول.
Document { get; }يحصل على مستند العقدة.
FirstChild { get; }
IsBordersVisible { get; set; }يحصل أو يعيّن قيمة تشير إلى ما إذا كان حد الجدول مرئيًا.
IsComposite { get; }
LastChild { get; }
LastModifiedTime { get; set; }يحصل أو يعيّن وقت آخر تعديل.
NextSibling { get; }يحصل على العقدة التالية في نفس مستوى شجرة العقد.
NodeType { get; }يحصل على نوع العقدة.
ParentNode { get; }يحصل على العقدة الأصلية.
PreviousSibling { get; }يحصل على العقدة السابقة في نفس مستوى شجرة العقد.
Tags { get; }يحصل على قائمة جميع العلامات في الفقرة.

الطرق

الاسمالوصف
override Accept(DocumentVisitor)يقبل زائر العقدة.
virtual AppendChildFirst<T1>(T1)
virtual AppendChildLast<T1>(T1)
override GetChildNodes<T1>()
GetEnumerator()
virtual InsertChild<T1>(int, T1)
InsertChildrenRange(int, IEnumerable<TableRow>)
InsertChildrenRange(int, params TableRow[])
RemoveChild<T1>(T1)

أمثلة

يوضح كيفية الحصول على النص من كل صف في الجدول.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_Tables();

// حمّل المستند إلى Aspose.Note.
Document document = new Document(dataDir + "Sample1.one");

// احصل على قائمة بعقد الجدول
IList<Table> nodes = document.GetChildNodes<Table>();

foreach (Table table in nodes)
{
    // التكرار عبر صفوف الجدول
    foreach (TableRow row in table)
    {
        // استرجاع النص
        string text = string.Join(Environment.NewLine, row.GetChildNodes<RichText>().Select(e => e.Text)) + Environment.NewLine;

        // طباعة النص على شاشة الإخراج
        Console.WriteLine(text);
    }
}

يوضح كيفية الحصول على النص من جدول.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_Tables();

// حمّل المستند إلى Aspose.Note.
Document document = new Document(dataDir + "Sample1.one");

// احصل على قائمة بعقد الجدول
IList<Table> nodes = document.GetChildNodes<Table>();

// تعيين عدد الجداول
int tblCount = 0;

foreach (Table table in nodes)
{
    tblCount++;
    Console.WriteLine("table # " + tblCount);

    // استرجاع النص
    string text = string.Join(Environment.NewLine, table.GetChildNodes<RichText>().Select(e => e.Text)) + Environment.NewLine;

    // طباعة النص على شاشة الإخراج
    Console.WriteLine(text);
}

يوضح كيفية الحصول على النص من خلايا الجدول.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_Tables();

// حمّل المستند إلى Aspose.Note.
Document document = new Document(dataDir + "Sample1.one");

// احصل على قائمة بعقد الجدول
IList<Table> nodes = document.GetChildNodes<Table>();        

foreach (Table table in nodes)
{
    // التكرار عبر صفوف الجدول
    foreach (TableRow row in table)
    {
        // احصل على قائمة بعقد TableCell
        // التكرار عبر خلايا الجدول
        foreach (TableCell cell in row)
        {
            // استرجاع النص
            string text = string.Join(Environment.NewLine, cell.GetChildNodes<RichText>().Select(e => e.Text)) + Environment.NewLine;

            // طباعة النص على شاشة الإخراج
            Console.WriteLine(text);
        }
    }
}

يوضح كيفية تعيين لون خلفية لخلية.

// إنشاء كائن من فئة Document
Document doc = new Document();

// تهيئة كائن فئة TableCell وتعيين محتوى النص
TableCell cell11 = new TableCell();
cell11.AppendChildLast(InsertTable.GetOutlineElementWithText("Small text"));
cell11.BackgroundColor = Color.Coral;

// تهيئة كائن فئة TableRow
TableRow row = new TableRow();
row.AppendChildLast(cell11);

Table table = new Table()
              {
                  IsBordersVisible = true,
                  Columns = { new TableColumn() { Width = 200 } }
              };
table.AppendChildLast(row);

OutlineElement oe = new OutlineElement();
oe.AppendChildLast(table);

Outline o = new Outline();
o.AppendChildLast(oe);

// تهيئة كائن فئة Page
Page page = new Page();
page.AppendChildLast(o);

doc.AppendChildLast(page);

doc.Save(Path.Combine(RunExamples.GetDataDir_Tables(), "SettingCellBackGroundColor.pdf"));

يعرض كيفية إضافة جدول جديد مع العلامة.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_Tags();

// إنشاء كائن من فئة Document
Document doc = new Document();

// تهيئة كائن فئة Page
Page page = new Page();

// تهيئة كائن فئة TableRow
TableRow row = new TableRow();

// تهيئة كائن فئة TableCell
TableCell cell = new TableCell();

// إدراج محتوى الخلية
cell.AppendChildLast(InsertTable.GetOutlineElementWithText("Single cell."));

// إضافة خلية إلى عقدة الصف
row.AppendChildLast(cell);

// تهيئة عقدة الجدول
Table table = new Table()
              {
                  IsBordersVisible = true,
                  Columns = { new TableColumn { Width = 70 } }
              };

// إدراج عقدة الصف في الجدول
table.AppendChildLast(row);

// إضافة علامة إلى عقدة الجدول هذه
table.Tags.Add(NoteTag.CreateQuestionMark());

Outline outline = new Outline();
OutlineElement outlineElem = new OutlineElement();

// إضافة عقدة جدول
outlineElem.AppendChildLast(table);

// إضافة عناصر المخطط
outline.AppendChildLast(outlineElem);
page.AppendChildLast(outline);
doc.AppendChildLast(page);

// حفظ مستند OneNote.
dataDir = dataDir + "AddTableNodeWithTag_out.one";
doc.Save(dataDir);

يوضح كيفية إنشاء جدول بعمود مقفل.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_Tables();

// إنشاء كائن من فئة Document
Document doc = new Document();

// تهيئة كائن فئة Page
Page page = new Page();

// تهيئة كائن فئة TableRow
TableRow row1 = new TableRow();

// تهيئة كائن فئة TableCell وتعيين محتوى النص
TableCell cell11 = new TableCell();
cell11.AppendChildLast(InsertTable.GetOutlineElementWithText("Small text"));
row1.AppendChildLast(cell11);

// تهيئة كائن فئة TableRow
TableRow row2 = new TableRow();

// تهيئة كائن فئة TableCell وتعيين محتوى النص
TableCell cell21 = new TableCell();
cell21.AppendChildLast(InsertTable.GetOutlineElementWithText("Long   text    with    several   words and    spaces."));
row2.AppendChildLast(cell21);

// تهيئة كائن فئة Table
Table table = new Table()
              {
                  IsBordersVisible = true,
                  Columns = { new TableColumn { Width = 70, LockedWidth = true } }
              };

// إضافة صفوف
table.AppendChildLast(row1);
table.AppendChildLast(row2);

Outline outline = new Outline();
OutlineElement outlineElem = new OutlineElement();

// إضافة عقدة جدول
outlineElem.AppendChildLast(table);

// إضافة عقدة عنصر المخطط
outline.AppendChildLast(outlineElem);

// إضافة عقدة المخطط
page.AppendChildLast(outline);

// إضافة عقدة صفحة
doc.AppendChildLast(page);
dataDir = dataDir + "CreateTableWithLockedColumns_out.one";
doc.Save(dataDir);

يوضح كيفية إنشاء جدول جديد.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_Tables();

// إنشاء كائن من فئة Document
Document doc = new Document();

// تهيئة كائن فئة Page
Page page = new Page();

// تهيئة كائن فئة TableRow
TableRow row1 = new TableRow();

// تهيئة كائنات فئة TableCell
TableCell cell11 = new TableCell();
TableCell cell12 = new TableCell();
TableCell cell13 = new TableCell();

// إلحاق عناصر المخطط في خلية الجدول
cell11.AppendChildLast(GetOutlineElementWithText("cell_1.1"));
cell12.AppendChildLast(GetOutlineElementWithText("cell_1.2"));
cell13.AppendChildLast(GetOutlineElementWithText("cell_1.3"));

// خلايا الجدول إلى صفوف
row1.AppendChildLast(cell11);
row1.AppendChildLast(cell12);
row1.AppendChildLast(cell13);

// تهيئة كائن فئة TableRow
TableRow row2 = new TableRow();

// تهيئة كائنات فئة TableCell
TableCell cell21 = new TableCell();
TableCell cell22 = new TableCell();
TableCell cell23 = new TableCell();

// إلحاق عناصر المخطط في خلية الجدول
cell21.AppendChildLast(GetOutlineElementWithText("cell_2.1"));
cell22.AppendChildLast(GetOutlineElementWithText("cell_2.2"));
cell23.AppendChildLast(GetOutlineElementWithText("cell_2.3"));

// إلحاق خلايا الجدول إلى صفوف
row2.AppendChildLast(cell21);
row2.AppendChildLast(cell22);
row2.AppendChildLast(cell23);

// تهيئة كائن فئة Table وتعيين عرض الأعمدة
Table table = new Table()
              {
                  IsBordersVisible = true,
                  Columns = { new TableColumn { Width = 200 }, new TableColumn { Width = 200 }, new TableColumn { Width = 200 } }
              };

// إلحاق صفوف الجدول بالجدول
table.AppendChildLast(row1);
table.AppendChildLast(row2);

// تهيئة كائن Outline
Outline outline = new Outline();

// تهيئة كائن OutlineElement
OutlineElement outlineElem = new OutlineElement();

// إضافة الجدول إلى عقدة عنصر المخطط
outlineElem.AppendChildLast(table);

// إضافة عنصر المخطط إلى المخطط
outline.AppendChildLast(outlineElem);

// إضافة المخطط إلى عقدة الصفحة
page.AppendChildLast(outline);

// إضافة الصفحة إلى عقدة المستند
doc.AppendChildLast(page);
dataDir = dataDir + "InsertTable_out.one";
doc.Save(dataDir);

انظر أيضًا

الفئة Style الفئة TableCell