إنشاء جدول محتويات في Aspose.Words لـ Java

مقدمة لإنشاء جدول المحتويات في Aspose.Words لـ Java

في هذا البرنامج التعليمي، سنرشدك خلال عملية إنشاء جدول محتويات (TOC) باستخدام Aspose.Words for Java. يعد TOC ميزة حاسمة لإنشاء مستندات منظمة. سنغطي كيفية تخصيص مظهر وتخطيط جدول المحتويات.

المتطلبات الأساسية

قبل أن تبدأ، تأكد من تثبيت Aspose.Words for Java وإعداده في مشروع Java الخاص بك.

الخطوة 1: إنشاء مستند جديد

أولاً، لنقم بإنشاء مستند جديد للعمل عليه.

Document doc = new Document();

الخطوة 2: تخصيص أنماط جدول المحتويات

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

doc.getStyles().getByStyleIdentifier(StyleIdentifier.TOC_1).getFont().setBold(true);

الخطوة 3: إضافة محتوى إلى المستند الخاص بك

يمكنك إضافة المحتوى الخاص بك إلى المستند. سيتم استخدام هذا المحتوى لإنشاء جدول المحتويات.

الخطوة 4: إنشاء جدول المحتويات

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

// قم بإدراج حقل جدول المحتويات في الموقع المطلوب في المستند الخاص بك.
FieldToc fieldToc = new FieldToc();
doc.getFirstSection().getBody().getFirstParagraph().appendChild(fieldToc);

الخطوة 5: احفظ المستند

وأخيرًا، احفظ المستند باستخدام جدول المحتويات.

doc.save("your_output_path_here");

تخصيص علامات الجدولة في TOC

يمكنك أيضًا تخصيص علامات الجدولة في جدول المحتويات للتحكم في تخطيط أرقام الصفحات. إليك كيفية تغيير علامات الجدولة:

Document doc = new Document("Table of contents.docx");

for (Paragraph para : (Iterable<Paragraph>) doc.getChildNodes(NodeType.PARAGRAPH, true))
{
    if (para.getParagraphFormat().getStyle().getStyleIdentifier() >= StyleIdentifier.TOC_1 &&
        para.getParagraphFormat().getStyle().getStyleIdentifier() <= StyleIdentifier.TOC_9)
    {
        //احصل على علامة التبويب الأولى المستخدمة في هذه الفقرة، والتي تقوم بمحاذاة أرقام الصفحات.
        TabStop tab = para.getParagraphFormat().getTabStops().get(0);
        
        // قم بإزالة علامة التبويب القديمة.
        para.getParagraphFormat().getTabStops().removeByPosition(tab.getPosition());
        
        // قم بإدراج علامة تبويب جديدة في موضع معدل (على سبيل المثال، 50 وحدة إلى اليسار).
        para.getParagraphFormat().getTabStops().add(tab.getPosition() - 50.0, tab.getAlignment(), tab.getLeader());
    }
}

doc.save("output.docx");

أصبح لديك الآن جدول محتويات مخصص في مستندك مع علامات جدولة معدلة لمحاذاة رقم الصفحة.

خاتمة

في هذا البرنامج التعليمي، اكتشفنا كيفية إنشاء جدول محتويات (TOC) باستخدام Aspose.Words for Java، وهي مكتبة قوية للعمل مع مستندات Word. يعد جدول المحتويات المنظم جيدًا أمرًا ضروريًا لتنظيم المستندات الطويلة والتنقل فيها، ويوفر Aspose.Words الأدوات اللازمة لإنشاء جداول المحتويات وتخصيصها دون عناء.

الأسئلة الشائعة

كيف يمكنني تغيير تنسيق إدخالات جدول المحتويات؟

يمكنك تعديل الأنماط المرتبطة بمستويات جدول المحتويات باستخدامdoc.getStyles().getByStyleIdentifier(StyleIdentifier.TOC_X)، حيث X هو مستوى TOC.

كيف يمكنني إضافة المزيد من المستويات إلى جدول المحتويات الخاص بي؟

لتضمين المزيد من المستويات في جدول المحتويات، يمكنك تعديل حقل جدول المحتويات وتحديد العدد المطلوب من المستويات.

هل يمكنني تغيير مواضع علامات الجدولة لإدخالات جدول المحتويات المحددة؟

نعم، كما هو موضح في مثال التعليمات البرمجية أعلاه، يمكنك تغيير مواضع علامات الجدولة لإدخالات جدول المحتويات المحددة عن طريق التكرار خلال الفقرات وتعديل علامات الجدولة وفقًا لذلك.