العمل مع جدول المحتويات

وفي كثير من الأحيان ستعملون مع الوثائق التي تحتوي على جدول محتويات. استخدام Aspose.Words يمكنك إدخال جدول محتوياتك الخاص أو إعادة بناء جدول المحتويات الحالي في الوثيقة باستخدام بضعة خطوط رمزية

وتحدد هذه المادة كيفية العمل في مجال جدول المحتويات وتبين ما يلي:

-كيف تُدخل علامة تجارية جديدة

  • تحديث لجان الخيارات التقنية الجديدة أو القائمة في الوثيقة.
  • تحديد مفاتيح التحكم في شكل اللجنة وهيكلها العام.
  • كيفية تعديل أساليب وظهور جدول المحتويات.
  • كيف يزيل كامل TOC ميدانياً إلى جانب جميع القيود الواردة في الوثيقة.

Insert Table of Contents Programmatically

يمكنك إدخال TOC (جدول المحتويات) الحقل في الوثيقة في الموقع الحالي بدعوة InsertTableOfContents طريقة

ويمكن بناء جدول للمحتويات في وثيقة وورد بعدة طرق وشكلها باستخدام مجموعة متنوعة من الخيارات. الملعب يتحول إلى الطريقة التي تتحكم بها في طريقة بناء الطاولة وعرضها في وثيقتك

مفاتيح التبديل التي تستخدم في TOC تدرج في Microsoft Word هي "" / “. ويمكن الاطلاع في وقت لاحق في المادة على وصفات هذه المفاتيح وكذلك على قائمة بالمفاتيح المدعومة. يمكنك إما استخدام ذلك الدليل للحصول على المفاتيح الصحيحة أو إذا كان لديك بالفعل وثيقة تحتوي على مماثلة TOC أنك تريد أن تظهر الرموز الميدانية (ALT+F9) وتنسخ التبديل مباشرة من الميدان.

ويبيّن المثال الرمزي التالي كيفية إدراج حقل من جدول المحتويات في وثيقة:

ويبين المثال الرمزي التالي كيفية إدراج جدول للمحتويات في وثيقة تستخدم أساليب العناوين كقيدات:

The code demonstrates the new table of contents is inserted into a blank document. The DocumentBuilder ويُستخدم بعد ذلك في إدخال بعض نماذج المحتوى التي تُشكّل باستخدام أسلوب العناوين المناسب الذي يُستخدَم في تحديد المحتوى الذي سيُدرج في لجنة الخيارات التقنية. السطور التالية ثم تفجر TOC عن طريق تحديث الحقول ورسم صفحة الوثيقة.

insert-table-of-contents-field-aspose-words-java

الجدول المستكمل للمحتويات

Aspose.Words يسمح لك بتحديث كامل TOC مع بعض خطوط الشفرة ويمكن القيام بذلك من أجل الحصول على مدخل جديد TOC أو لتحديث قائمة TOC وبعد إدخال تغييرات على الوثيقة.

يجب استخدام الأسلوبين التاليين لتحديث TOC المجالات الواردة في الوثيقة:

  1. Document.updateFields()
  2. Document.updatePageLayout()

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

المثال الرمزي التالي يبين كيف يعاد بناءه بالكامل TOC الميادين الواردة في الوثيقة عن طريق الاستناد إلى تحديثات ميدانية:

النداء الأول Document.updateFields() سيبني <span notrans="<span notrans=” TOC"="">" جميع النصوص مأهولة بالسكان TOC يبدو مكتملاً والشيء الوحيد المفقود هو أرقام الصفحات التي تظهر الآن ب " ؟ “.

النداء الثاني Document.updatePageLayout() سيبني تصميم الوثيقة في الذاكرة. وينبغي القيام بذلك لجمع عدد الصفحات من القيد. The correct page numbers calculated from this call are then inserted into the TOC.

Use Switches to Control Table of Contents Behavior

كما في أي ميدان آخر TOC ويمكن للميدان أن يقبل التحولات المحددة في القانون الميداني التي تتحكم في كيفية بناء جدول المحتويات. وتُستخدم بعض مفاتيح التبديل للتحكم في أي قيود مشمولة وعلى أي مستوى بينما تستخدم مفاتيح أخرى للسيطرة على مظهر لجنة الخيارات التقنية. ويمكن الجمع بين المتبدلات للسماح بإعداد جدول معقد للمحتويات.

ccontrol-table-of-contents-field-aspose-words-java

وبحلول التقصير، تُدرج هذه التبديلات المذكورة أعلاه عند إدراج تقصير TOC في الوثيقة. ألف TOC ولا تشمل أي مفاتيح مبدلة المحتوى من أساليب العناوين الأساسية (مثلاً إذا تم تحديد مفتاح التشغيل).

المتاح TOC تحويلات تدعمها Aspose.Words وترد أدناه تفاصيل استخداماتها. ويمكن تقسيمها إلى أقسام منفصلة تستند إلى نوعها. وتُعرِّف التبديلات في القسم الأول المحتوى الذي ينبغي إدراجه في TOC والمفاتيح في القسم الثاني تتحكم في ظهور التكتيك

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

مفاتيح الدخول

Switch الوصف
Heading Styles
* (O Switch)*

هذا التبديل يعرف أن TOC يجب أن يُبنى من على أساليب متجهة In Microsoft Word, ويحدد العنوان ١ - العنوان 9. Aspose.Words وتُمثل هذه الأساليب في تعداد محددات الهوية ذي الصلة. ويمثل هذا التعداد مؤشراً محلياً يعتمد على أسلوب معين، على سبيل المثال، StyleIdentifier.Heading1 يُمثّلُ أسلوبَ العنوانَ 1. وباستخدام ذلك، يمكن استرجاع شكل وخصائص هذا الأسلوب من مجموعة نموذج الوثيقة. يمكن استرجاع صف الطراز المقابل من Document.Styles التحصيل عن طريق استخدام الممتلكات المفهرسة من نوع محدد الهوية.

![style-table-of-contents-field-aspose-words-java](/words/java/working-with-table-of-contents/how-to-insert-and-work-with-the-table-of-contents-field-3.png)



ويدرج في جدول المحتويات أي محتوى يتكون من هذه الأساليب. وسيحدد مستوى العنوان المستوى الهرمي المقابل للدخول في لجنة الخيارات التقنية. فعلى سبيل المثال، ستُعامل فقرة ذات أسلوب " العنوان 1 " على أنها المستوى الأول. `TOC` وفي حين أن فقرة تحمل العنوان 2 ستعامل على أنها المستوى التالي في التسلسل الهرمي وما إلى ذلك.

| | **Outline Levels**
*
|

ويمكن لكل فقرة أن تحدد مستوى موجز في إطار خيارات الفقرة.

![modify-table-of-contents-field-aspose-words-java](/words/java/working-with-table-of-contents/how-to-insert-and-work-with-the-table-of-contents-field-4.png)



وينص هذا الإطار على المستوى الذي ينبغي أن تعامل به هذه الفقرة في الهيكل الهرمي للوثائق. وهذه ممارسة شائعة الاستخدام تُستخدم بسهولة في هيكلة مخطط الوثيقة. هذا التسلسل الهرمي يمكن أن يُنظر إليه بالتغيّر إلى الرؤية الخارجية Microsoft Word. وكما هو الحال بالنسبة لأساليب العناوين، يمكن أن يكون هناك مستوى ١ - ٩ مستويات عامة بالإضافة إلى مستوى " النص الأساسي ". ستظهر المستويات الرئيسية 1-9 في `TOC` في المستوى المقابل للتسلسل الهرمي
ويُدرج في لجنة الخيارات التقنية أي محتوى له مستوى مخطّط إما مبيّن في أسلوب الفقرة أو مباشرة في الفقرة ذاتها. In Aspose.Words ويمثل مستوى المخطط العام `ParagraphFormat.OutlineLevel` ممتلكات رقم الفقرة. يُمثَّل مستوى الخطوط العامة لأسلوب الفقرة بنفس الطريقة بـ `Style.ParagraphFormat` ملكية

| | **Custom Styles**
*
|

وسيسمح هذا التحول باستخدام أساليب العرف عند جمع القيود التي ستستخدم في لجنة الخيارات التقنية. وكثيراً ما يُستخدم ذلك بالاقتران مع التبديل " فو " ليشمل أساليب العرف إلى جانب أساليب الرفع في العناوين الأساسية في لجنة الخيارات التقنية.
وينبغي أن توضع بارامترات التبديل ضمن علامات الكلمات. ويمكن إدراج العديد من أساليب العرف، بالنسبة لكل أسلوب، ينبغي أن يعقب ذلك اسم فاصلة يعقبها المستوى الذي ينبغي أن يظهر فيه الأسلوب. `TOC` كما. وهناك أيضاً أساليب أخرى تفصلها فاصلة.
على سبيل المثال

{ TOC \o "1-3" \t "CustomHeading1, 1,   CustomHeading2, 2"}

سيستخدم محتوى مصمم مع شركة (Custom Heading1) كمحتوى من المستوى الأول `TOC` (ب) في المستوى 2.

| | Use TC Fields
*(F وL)*
|

في النسخ القديمة Microsoft Word, الطريقة الوحيدة لبناء `TOC` كان استخدام حقول (تي سي) وتدرج هذه الميادين مخبأة في الوثيقة حتى عندما تظهر الرموز الميدانية. وهي تشمل النص الذي ينبغي أن يُعرض في المدخل وفي `TOC` مبنية منهم ولا تستخدم هذه الوظيفة حالياً في كثير من الأحيان ولكن قد لا تزال مفيدة في بعض المناسبات لإدراج قيود في تلك المناسبات. `TOC` ولا يمكن الاطلاع عليها في الوثيقة.
عندما تدرج هذه الحقول تظهر مخبأة حتى عندما تظهر الرموز الميدانية لا يمكن رؤيتها بدون إظهار محتوى مخفي ورؤية هذه المجالات يجب اختيار صيغة الفقرة.

![setup-table-of-contents-field-aspose-words-java](/words/java/working-with-table-of-contents/how-to-insert-and-work-with-the-table-of-contents-field-5.png)

ويمكن إدراج هذه الحقول في وثيقة في أي مكان مثل أي ميدان آخر ويمثلها `FieldType.FieldTOCEntry` العد
مفتاح الـ "إف" في `TOC` ويُستخدم لتحديد استخدام حقول التعاون التقني كقيد. والتحول من تلقاء نفسه دون أي تعريف إضافي يعني أن أي ميدان من مجالات التعاون التقني في الوثيقة سيدرج. أي بارامتر إضافي، في كثير من الأحيان رسالة واحدة، سيحدد أن حقول رابع كلوريد ثلاثي كلوريد الكربون التي لديها مفتاح مطابق للـ (إف) ستدرج في لجنة الخيارات التقنية. على سبيل المثال

{ TOC \f t }

لن تشمل سوى ميادين التعاون التقني مثل

{ TC \f t }

The `TOC` وللميدان أيضاً مفتاح ذي صلة، يحدد مفتاح " / / " أنه لا يشمل سوى ميدان التعاون التقني ذي المستويات داخل النطاق المحدد.

![table-of-contents-field-aspose-words-java](/words/java/working-with-table-of-contents/how-to-insert-and-work-with-the-table-of-contents-field-6.png)



The `TC` الحقول نفسها يمكن أن تكون {several, `multiple`, a few, `many`, numerous} مفاتيح ثابتة وهي:

-إف. ♪

- لا - يحدد أي مستوى في `TOC` هذا الحقل سيظهر ألف `TOC` ولا يشمل هذا التحول نفسه ميدان التعاون التقني إلا إذا كان ضمن النطاق المحدد.

- عدد الصفحات لهذا `TOC` الدخول لم يظهر ويمكن الاطلاع على مدونة عينات لطريقة إدخال حقول رابع كلوريد الكربون في القسم التالي.

|

التبديلات ذات الصلة

Switch الوصف
Omit Page Numbers
* (N Switch)*

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

 
{TOC \o "1-4" \n "3-4" }

وأرقام الصفحات الواردة في قوائم المستويين 3 و 4 ستكون مخبأة إلى جانب النقاط القيادية (إن وجدت). ولتحديد مستوى واحد فقط ينبغي استخدام نطاق واحد، على سبيل المثال، فإن " ١ - ١ " لا تستبعد أرقام الصفحات إلا للرتبة الأولى.
ولن يغفل توفير أي نطاق من المستويات أرقام الصفحات على جميع المستويات في لجنة الخيارات التقنية. This is useful to set when exporting a document to HTML or a similar format. ويرجع ذلك إلى أن الصيغ القائمة على نظام HTML ليس لها أي مفهوم للصفحة وبالتالي لا تحتاج إلى أي ترقيم للصفحة.

![table-of-contents-aspose-words-java](/words/java/working-with-table-of-contents/how-to-insert-and-work-with-the-table-of-contents-field-7.png)

| | Insert as Hyperlinks
* (H Switch)* |

هذا التبديل يحدد `TOC` تُدرج القيود كوصلات ضغط. عند النظر إلى وثيقة في Microsoft Word هذه القيود ستظهر كنص عادي داخل `TOC` غير أنها متصلة ارتباطاً وثيقاً ويمكن بالتالي استخدامها في نقل موقع الدخول الأصلي في الوثيقة باستخدام *Ctrl + left Click* Microsoft Word. وعند إدراج هذا التبديل، يتم أيضا الحفاظ على هذه الروابط في أشكال أخرى. For instance, in HTML based formats including EPUB and rendered formats such as PDF and XPS, وسيتم تصديرها كوصلات عمل.
بدون هذا المفتاح `TOC` وفي جميع هذه النواتج سيتم تصديرها بوصفها نصا واضحا ولن تثبت هذا السلوك. وإذا افتُتحت وثيقة في MS Word، لن يكون نص القيد قابلا للنقاش أيضا بهذه الطريقة، ولكن لا يزال بالإمكان استخدام أرقام الصفحات لنقل الدخول الأصلي.

![tree-table-of-contents-field-aspose-words-java](/words/java/working-with-table-of-contents/how-to-insert-and-work-with-the-table-of-contents-field-8.png)

| | **Set Separator Character**
*(P Switch)*
|

ويسمح هذا التبديل بتغيير المحتوى الذي يفصل عنوان الدخول وعدد الصفحات بسهولة في لجنة الخيارات التقنية. The separator to use should be specified after this shift and attached in speech marks.
وخلافا لما هو موثق في وثائق المكتب، لا يمكن استخدام طابع واحد إلا بدلا من أن يصل إلى خمسة. وينطبق هذا على كل من كلمة ميم إس وورد Aspose.Words.
ولا يوصى باستخدام هذا التبديل لأنه لا يسمح بقدر كبير من السيطرة على ما كان يستخدمه لفصل القيود وأرقام الصفحات في لجنة الخيارات التقنية. وبدلا من ذلك، يوصى بتحرير ما هو مناسب `TOC` أسلوب من هذا القبيل `StyleIdentifier.TOC1` ومن هناك حرر أسلوب الزعيم مع الوصول إلى أعضاء محددين ويمكن الاطلاع في وقت لاحق على تفاصيل أخرى عن كيفية القيام بذلك في المادة.

![list-table-of-contents-field-aspose-words-java](/words/java/working-with-table-of-contents/how-to-insert-and-work-with-the-table-of-contents-field-9.png)

| | **Preserve Tab Entries**
* (W Switch)* |

وباستخدام هذا التبديل سينص على أن أي قيود تكون ذات طابع تابوي، على سبيل المثال، عنواناً يحتوي على جدول في نهاية الخط، سيُحتفظ به كشخصية حسابية مناسبة عند اكتظاظ لجنة الخيارات التقنية. هذا يعني أن وظيفة شخصية (تاب) ستكون موجودة `TOC` ويمكن استخدامها لتشكيل المدخل. فعلى سبيل المثال، قد تستخدم بعض القيود التوقيفات والشخصيات المشابهة في الحيز المتساوي للنص. ما دامت المقابلة `TOC` يُعرّفُ المستوىَ ما يُعادلُ توقّفَ التافه ثمّ `TOC` وستظهر القيود مع فترات مباعدة مماثلة.

وفي نفس الحالة إذا لم يكن هذا التبديل معرَّفاً، تُحوَّل شخصيات التافه إلى مكافئات فضائية بيضاء كقبوات غير عاملة. ولن يظهر الناتج بعد ذلك كما هو متوقع.

![tab-table-of-contents-field-aspose-words-java](/words/java/working-with-table-of-contents/how-to-insert-and-work-with-the-table-of-contents-field-10.png)

| | **Preserve New Line Entries**
*(X Switch)*
|

وعلى غرار التبديل الوارد أعلاه، يحدد هذا التبديل أن العناوين التي تمتد على خطوط متعددة (استخدام خصائص خطية جديدة، وليس فقرات منفصلة) ستُحفظ كما هي في لجنة الخيارات التقنية المتولدة. فعلى سبيل المثال، يمكن لعنصر ينتشر عبر خطوط متعددة أن يستخدم طابع الخط الجديد (Ctrl + Enter أو) `ControlChar.LineBreak`لفصل المحتوى عبر خطوط مختلفة مع تحديد هذا التبديل، الدخول في `TOC` وستحافظ على هذه الشخصيات الجديدة على النحو المبين أدناه.

وفي هذه الحالة، إذا لم يُعرّف التبديل، تُحوّل الشخصيات الجديدة إلى مكان أبيض واحد.

![tab-space-table-of-contents-field-aspose-words-java](/words/java/working-with-table-of-contents/how-to-insert-and-work-with-the-table-of-contents-field-11.png)

|

Insert TC Fields

يمكنك إدخال حقل “تي سي” الجديد في الموقع الحالي DocumentBuilder عن طريق الاتصال DocumentBuilder.InsertField طريقة وتحديد الاسم الميداني على أنه " م ت " إلى جانب أي تبديلات ضرورية.

ويبين المثال الرمزي التالي كيفية إدخال TC الميدان في الوثيقة باستخدام DocumentBuilder.

في كثير من الأحيان يُعيَّن خط معين للنص TOC وقد وُضِعَت مع TC الحقل والطريقة السهلة للقيام بذلك في MS Word هي إبراز النص والصحافة ALT+SHIFT+O. هذا يخلق تلقائياً TC حقل باستخدام النص المختار نفس التقنية يمكن إنجازها من خلال الشفرة الرمز الوارد أدناه سيجد نصاً يطابق المدخلات ويدخل TC ميداني في نفس موقع النص. ويستند الرمز إلى نفس الأسلوب المستخدم في المادة. ويبيّن المثال الرمزي التالي كيف يجد ويدخل TC في النص الوارد في وثيقة.

تعديل جدول المحتويات

تغيير الشكل

The formatting of entries in the TOC لا يستخدم النمط الأصلي للقيدات المميزة، وبدلا من ذلك، يتم تشكيل كل مستوى باستخدام مكافئ TOC أسلوب. على سبيل المثال، المستوى الأول في TOC مصمم مع TOC1 الطريقة، المستوى الثاني مصمم مع TOC2 اسلوب و هكذا هذا يعني أن لتغيير نظرة TOC يجب تعديل هذه الأساليب In Aspose.Words هذه الأساليب ممثلة بمعتمد محلي StyleIdentifier.TOC1 من خلال StyleIdentifier.TOC9 ويمكن استرجاعها من Document.Styles جمع المعلومات باستخدام أجهزة تحديد الهوية هذه

وبمجرد استرجاع الأسلوب المناسب للوثيقة، يمكن تعديل شكل هذا الأسلوب. وستنعكس أي تغييرات في هذه الأساليب تلقائياً في اللجان الفرعية في الوثيقة.

The following code example changes a formatting property used in the first level TOC أسلوب.

ومن المفيد أيضا ملاحظة أن أي شكل مباشر للفقرة (المحددة في الفقرة نفسها وليس في الأسلوب) يُدرج في القائمة. TOC سوف يتم نسخها من خلال الدخول في TOC. على سبيل المثال، إذا استخدم أسلوب العنوان 1 في تحديد محتوى TOC وهذا النمط له شكل بارد في حين أن الفقرة لها أيضا شكل مائل ينطبق عليها مباشرة. النتيجة TOC ولن يكون الدخول جريء لأن ذلك يشكل جزءاً من شكل نمطي، غير أنه سيكون إيجازاً نظراً إلى أن هذه الفقرة تصاغ بشكل مباشر.

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

استخدام Style الفئة المسترجعة خصيصاً TOC المستوى الذي ترغب في تعديله، يمكنك أيضا تعديل كيف تظهر هذه في الوثيقة.

لتغيير كيف يبدو هذا أولاً Style.ParagraphFormat ويجب أن يُستدعى لاسترجاع صيغة الفقرة للأسلوب. من هذا، يمكن استرجاع التوقيف عن طريق الاتصال ParagraphFormat.TabStops والتوقيف المناسب تم تعديله وباستخدام هذه التقنية نفسها يمكن تحريكها أو إزالتها كلياً

يُظهر المثال الرمزي التالي كيف يُعدّل موقف التوقّف الصحيح TOC الفقرات ذات الصلة.

(أ) إزالة جدول المحتويات من الوثيقة

يمكن حذف جدول محتويات من الوثيقة عن طريق إزالة جميع البنود الموجودة بين FieldStart and FieldEnd node of the TOC الحقل

الرمز أدناه يُظهر هذا إزالة الألغام TOC الحقل أبسط من حقل عادي ونحن لا نتابع الحقول المحورة. بدلاً من ذلك، نتفقد FieldEnd العقد من النوع FieldType.FieldTOC مما يعني أننا صادفنا نهاية التكتيك الحالي ويمكن استخدام هذه التقنية في هذه الحالة دون القلق بشأن أي حقول ملونة يمكن أن نفترض أن أي وثيقة مُشكّلة على نحو سليم لن يكون لها أي استعارة كاملة TOC حقل داخل آخر TOC الحقل

أولاً FieldStart كل عقد TOC يتم جمعها وتخزينها. المحددة TOC ومن ثم يُعدَّد بحيث يتم زيارة وتخزين جميع المعالم داخل الميدان. The nodes are then removed from the document. ويبين المثال الرمزي التالي كيفية إزالة محدد TOC من وثيقة

جدول المحتويات

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

العمل مع الحاشية والتاريخ Java العمل مع علامات الكتاب في Java