UpdateListLabels

Document.UpdateListLabels method

تحديث تسميات القائمة لجميع عناصر القائمة في المستند.

public void UpdateListLabels()

ملاحظات

تقوم هذه الطريقة بتحديث خصائص تسمية القائمة مثلLabelValue و LabelString لكل واحدListLabel الكائن في المستند.

أيضًا، يتم أحيانًا استدعاء هذه الطريقة ضمنيًا عند تحديث حقول المستند. هذه الطريقة مطلوبة لأن بعض الحقول التي قد تشير إلى أرقام قوائم (مثل جدول المحتويات أو المرجع) تحتاج إلى تحديثها.

أمثلة

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

Document doc = new Document(MyDir + "Rendering.docx");
doc.UpdateListLabels();

NodeCollection paras = doc.GetChildNodes(NodeType.Paragraph, true);

// ابحث إن كانت لدينا قائمة الفقرات. في مستندنا، تستخدم قائمتنا أرقامًا عربية بسيطة،
// والتي تبدأ عند ثلاثة وتنتهي عند ستة.
foreach (Paragraph paragraph in paras.OfType<Paragraph>().Where(p => p.ListFormat.IsListItem).ToList())
{
    Console.WriteLine($"List item paragraph #{paras.IndexOf(paragraph)}");

    // هذا هو النص الذي نحصل عليه عندما نخرج هذه العقدة إلى تنسيق نصي.
     // سيحذف هذا النص تسميات القائمة. قم بقص أي أحرف تنسيق للفقرات.
    string paragraphText = paragraph.ToString(SaveFormat.Text).Trim();
    Console.WriteLine($"\tExported Text: {paragraphText}");

    ListLabel label = paragraph.ListLabel;

    // يُحدد هذا موضع الفقرة في المستوى الحالي من القائمة. إذا كانت لدينا قائمة ذات مستويات متعددة،
    // هذا سيخبرنا ما هو الموضع على هذا المستوى.
    Console.WriteLine($"\tNumerical Id: {label.LabelValue}");

    // قم بدمجهما معًا لتضمين تسمية القائمة مع النص في الإخراج.
    Console.WriteLine($"\tList label combined with text: {label.LabelString} {paragraphText}");
}

أنظر أيضا

Document.UpdateFields Document.UpdatePageLayout