الفئة NumberList

NumberList class

يمثل القائمة المرقمة أو ذات النقاط.

public class NumberList

المُنشئات

الاسمالوصف
NumberList(string, string, int)يُنشئ مثيلًا جديدًا من الفئة NumberList. هذا المثيل يمثل قائمة ذات رموز نقطية.
NumberList(string, NumberFormat, string, int)يُنشئ مثيلًا جديدًا من الفئة NumberList. هذا المثيل يمثل قائمة مرقمة.

الخصائص

الاسمالوصف
Font { get; set; }يحصل أو يعيّن اسم الخط.
FontColor { get; set; }يحصل أو يضبط لون الخط.
FontSize { get; set; }يحصل أو يضبط حجم الخط.
Format { get; set; }يحصل أو يعيّن تنسيق رأس السطر. بالنسبة للقوائم ذات الرموز النقطية يمثل رمزًا نقطيًا.
IsBold { get; set; }يحصل أو يضبط قيمة تشير إلى ما إذا كان نمط النص غامقًا.
IsItalic { get; set; }يحصل أو يضبط قيمة تشير إلى ما إذا كان نمط النص مائلًا.
LastModifiedTime { get; set; }يحصل أو يعيّن وقت التعديل الأخير.
NumberFormat { get; set; }يحصل أو يعيّن تنسيق الرقم المستخدم لمجموعة من الكائنات المرقمة تلقائيًا. يجب أن يكون فارغًا للقوائم ذات الرموز النقطية.
Restart { get; set; }يحصل أو يعيّن القيمة الرقمية التي تتجاوز القيمة العددية التلقائية لعنصر القائمة.

الطرق

الاسمالوصف
Equals(NumberList)يحدد ما إذا كان الكائن المحدد يساوي الكائن الحالي.
override Equals(object)يحدد ما إذا كان الكائن المحدد يساوي الكائن الحالي.
override GetHashCode()يعمل كدالة تجزئة (hash) لهذا النوع.
GetNumberedListHeader(int)يحصل على رأس القائمة المرقمة.

أمثلة

يعرض كيفية استرجاع معلومات تنسيق القائمة.

string dataDir = RunExamples.GetDataDir_Text();

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

// استرجاع مجموعة العقد لعنصر المخطط
IList<OutlineElement> nodes = oneFile.GetChildNodes<OutlineElement>();

// تكرار عبر كل عقدة
foreach (OutlineElement node in nodes)
{
    if (node.NumberList != null)
    {
        NumberList list = node.NumberList;

        // استرجاع اسم الخط
        Console.WriteLine("Font Name: " + list.Font);

        // استرجاع طول الخط
        Console.WriteLine("Font Length: " + list.Font.Length);

        // استرجاع حجم الخط
        Console.WriteLine("Font Size: " + list.FontSize);

        // استرجاع لون الخط
        Console.WriteLine("Font Color: " + list.FontColor);

        // استرجاع التنسيق
        Console.WriteLine("Font format: " + list.Format);

        // تحقق من الغامق
        Console.WriteLine("Is bold: " + list.IsBold);

        // تحقق من المائل
        Console.WriteLine("Is italic: " + list.IsItalic);
        Console.WriteLine();
    }
}

يوضح كيفية إدراج قائمة جديدة بترقيم صيني.

string dataDir = RunExamples.GetDataDir_Text();

// تهيئة مستند OneNote
Document doc = new Document();

// تهيئة صفحة OneNote
Page page = new Page();
Outline outline = new Outline();

// تطبيق إعدادات نمط النص
ParagraphStyle defaultStyle = new ParagraphStyle { FontColor = Color.Black, FontName = "Arial", FontSize = 10 };

// الأرقام في نفس المخطط تُزاد تلقائيًا.
OutlineElement outlineElem1 = new OutlineElement() { NumberList = new NumberList("{0})", NumberFormat.ChineseCounting, "Arial", 10) };
RichText text1 = new RichText() { Text = "First", ParagraphStyle = defaultStyle };
outlineElem1.AppendChildLast(text1);

//------------------------
OutlineElement outlineElem2 = new OutlineElement() { NumberList = new NumberList("{0})", NumberFormat.ChineseCounting, "Arial", 10) };
RichText text2 = new RichText() { Text = "Second", ParagraphStyle = defaultStyle };
outlineElem2.AppendChildLast(text2);

//------------------------
OutlineElement outlineElem3 = new OutlineElement() { NumberList = new NumberList("{0})", NumberFormat.ChineseCounting, "Arial", 10) };
RichText text3 = new RichText() { Text = "Third", ParagraphStyle = defaultStyle };
outlineElem3.AppendChildLast(text3);

//------------------------
outline.AppendChildLast(outlineElem1);
outline.AppendChildLast(outlineElem2);
outline.AppendChildLast(outlineElem3);
page.AppendChildLast(outline);
doc.AppendChildLast(page);

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

يعرض كيفية إدراج قائمة جديدة مع الترقيم.

string dataDir = RunExamples.GetDataDir_Text();

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

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

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

// تهيئة كائن فئة TextStyle وتعيين خصائص التنسيق
ParagraphStyle defaultStyle = new ParagraphStyle { FontColor = Color.Black, FontName = "Arial", FontSize = 10 };

// تهيئة كائنات فئة OutlineElement وتطبيق الترقيم
// الأرقام في نفس المخطط تُزاد تلقائيًا.
OutlineElement outlineElem1 = new OutlineElement() { NumberList = new NumberList("{0})", NumberFormat.DecimalNumbers, "Arial", 10) };
RichText text1 = new RichText() { Text = "First", ParagraphStyle = defaultStyle };
outlineElem1.AppendChildLast(text1);

OutlineElement outlineElem2 = new OutlineElement() { NumberList = new NumberList("{0})", NumberFormat.DecimalNumbers, "Arial", 10) };
RichText text2 = new RichText() { Text = "Second", ParagraphStyle = defaultStyle };
outlineElem2.AppendChildLast(text2);

OutlineElement outlineElem3 = new OutlineElement() { NumberList = new NumberList("{0})", NumberFormat.DecimalNumbers, "Arial", 10) };
RichText text3 = new RichText() { Text = "Third", ParagraphStyle = defaultStyle };
outlineElem3.AppendChildLast(text3);

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

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

// إضافة عقدة الصفحة
doc.AppendChildLast(page);

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

انظر أيضًا

تعداد NumberFormat فئة Outline