يحدد رمز التبديل هذا أن `TOC` يجب أن يتم إنشاؤه من أنماط العناوين المضمنة. في Microsoft Word يتم تعريفها بواسطة العنوان 1 - العنوان 9. في Aspose.Words يتم تمثيل هذه الأنماط بواسطة تعداد StyleIdentifier المطابق. يمثل هذا التعداد معرفًا محليًا مستقلاً للنمط، على سبيل المثال `StyleIdentifier.Heading1` يمثل نمط العنوان 1. باستخدام هذا، يمكن استرداد تنسيق النمط وخصائصه من مجموعة الأنماط الخاصة بالمستند. يمكن استرداد فئة النمط المقابلة من المجموعة `Document.Styles` باستخدام الخاصية المفهرسة من النوع StyleIdentifier.
يتم تضمين أي محتوى منسق بهذه الأنماط في جدول المحتويات. سيحدد مستوى العنوان المستوى الهرمي المقابل للإدخال في جدول المحتويات. على سبيل المثال، سيتم التعامل مع فقرة ذات نمط عنوان 1 على أنها المستوى الأول في `TOC` بينما سيتم التعامل مع فقرة ذات عنوان 2 على أنها المستوى التالي في التسلسل الهرمي وما إلى ذلك.
| | **Outline Levels***(\التبديل)* |يمكن لكل فقرة تحديد مستوى المخطط التفصيلي ضمن خيارات الفقرة.
يحدد هذا الإعداد المستوى الذي يجب التعامل مع هذه الفقرة في التسلسل الهرمي للمستند. هذه ممارسة شائعة الاستخدام لتنظيم تخطيط المستند بسهولة. يمكن عرض هذا التسلسل الهرمي عن طريق التغيير إلى عرض المخطط التفصيلي في Microsoft Word. كما هو الحال مع أنماط العناوين، يمكن أن يكون هناك من 1 إلى 9 مستويات للمخطط التفصيلي بالإضافة إلى مستوى "النص الأساسي". ستظهر مستويات المخطط التفصيلي 1 - 9 في `TOC` في المستوى المقابل من التسلسل الهرمييتم تضمين أي محتوى بمستوى مخطط تفصيلي تم تعيينه في نمط الفقرة أو مباشرة على الفقرة نفسها في جدول المحتويات. في Aspose.Words يتم تمثيل مستوى المخطط التفصيلي بواسطة خاصية `ParagraphFormat.OutlineLevel` لعقدة الفقرة. يتم تمثيل مستوى المخطط التفصيلي لنمط الفقرة بنفس الطريقة بواسطة الخاصية `Style.ParagraphFormat`.
```
لاحظ أن أنماط العناوين المضمنة مثل العنوان 1 لها مستوى مخطط تفصيلي إلزامي تم تعيينه في إعدادات النمط.
```
| | **Custom Styles***(\T التبديل)* |سيسمح رمز التبديل هذا باستخدام الأنماط المخصصة عند تجميع الإدخالات لاستخدامها في جدول المحتويات. يُستخدم هذا غالبًا مع رمز التبديل \O لتضمين أنماط مخصصة مع أنماط العناوين المضمنة في جدول المحتويات.يجب أن تكون معلمات المفتاح محاطة بعلامات الكلام. يمكن تضمين العديد من الأنماط المخصصة، ويجب تحديد الاسم لكل نمط متبوعًا بفاصلة متبوعة بالمستوى الذي يجب أن يظهر به النمط في `TOC`. يتم أيضًا فصل الأنماط الأخرى بفاصلة أيضًا.على سبيل المثال
```csharp{ TOC \o "1-3" \t "CustomHeading1, 1, CustomHeading2, 2"}```
سيستخدم المحتوى المصمم بـ CustomHeading1 كمحتوى المستوى 1 في `TOC` وCustomHeading2 كمستوى 2.
| | **Use TC Fields***(\F و\L التبديلات)* |في الإصدارات الأقدم من Microsoft Word، كانت الطريقة الوحيدة لإنشاء `TOC` هي استخدام حقول TC. يتم إدراج هذه الحقول مخفية في المستند حتى عند ظهور رموز الحقول. وهي تتضمن النص الذي يجب عرضه في الإدخال ويتم إنشاء `TOC` منها. لا يتم الآن استخدام هذه الوظيفة في كثير من الأحيان ولكنها قد تكون مفيدة في بعض المناسبات لتضمين الإدخالات في `TOC` التي لم يتم وضع مسافة بادئة لها لتكون مرئية في المستند.عند إدراج هذه الحقول تظهر مخفية حتى عند عرض رموز الحقول. ولا يمكن رؤيتها دون إظهار المحتوى المخفي. لرؤية هذه الحقول يجب تحديد إظهار تنسيق الفقرة.
يمكن إدراج هذه الحقول في مستند في أي موضع مثل أي حقل آخر ويتم تمثيلها بواسطة تعداد `FieldType.FieldTOCEntry`.يتم استخدام رمز التبديل \F في `TOC` لتحديد أنه يجب استخدام حقول TC كإدخالات. ويعني التبديل من تلقاء نفسه دون أي معرف إضافي أنه سيتم تضمين أي حقل TC في المستند. ستحدد أي معلمة إضافية، غالبًا ما تكون حرفًا واحدًا، أن حقول TC التي تحتوي على مفتاح \f مطابق فقط هي التي سيتم تضمينها في جدول المحتويات. على سبيل المثال *
```csharp{ TOC \f t }```
سيتضمن فقط حقول TC مثل
```csharp{ TC \f t }```
يحتوي حقل `TOC` أيضًا على مفتاح تبديل ذي صلة، حيث يحدد المفتاح \L أنه يتم تضمين حقل TC فقط الذي يحتوي على مستويات ضمن النطاق المحدد.
يمكن أيضًا أن تحتوي حقول `TC` نفسها على عدة مفاتيح تعيين. هؤلاء هم:
- *\F - تم شرحه أعلاه.*
- *\L - يحدد المستوى الذي سيظهر فيه حقل TC هذا في `TOC`. وسيتضمن `TOC` الذي يستخدم نفس المفتاح حقل TC هذا فقط إذا كان ضمن النطاق المحدد.*
- _\N - لا يتم عرض ترقيم الصفحات لإدخال `TOC` هذا. يمكن العثور على نموذج التعليمات البرمجية لكيفية إدراج حقول TC في القسم التالي.
| ### المظهر المتعلق بالمفاتيح | يُحوّل | وصف | | :- | :- | | **Omit Page Numbers***(\N التبديل)* |يتم استخدام رمز التبديل هذا لإخفاء أرقام الصفحات لمستويات معينة من جدول المحتويات. على سبيل المثال يمكنك تحديد
```csharp{TOC \o "1-4" \n "3-4" }```
وسيتم إخفاء أرقام الصفحات الموجودة في إدخالات المستويين 3 و4 مع النقاط الرئيسية (إن وجدت). لتحديد مستوى واحد فقط، يجب الاستمرار في استخدام النطاق، على سبيل المثال، "1-1" سوف يستبعد أرقام الصفحات للمستوى الأول فقط.سيؤدي توفير أي نطاق للمستوى إلى حذف أرقام الصفحات لكافة المستويات في جدول المحتويات. يعد هذا مفيدًا عند تصدير مستند إلى HTML أو تنسيق مشابه. وذلك لأن التنسيقات المستندة إلى HTML لا تحتوي على أي مفهوم للصفحة وبالتالي لا تحتاج إلى أي ترقيم للصفحات.
| | **Insert As Hyperlinks***(\H التبديل)* |يحدد رمز التبديل هذا إدراج `TOC` إدخالات كارتباطات تشعبية. عند عرض مستند في Microsoft Word ستظل هذه الإدخالات تظهر كنص عادي داخل `TOC` ولكنها مرتبطة ارتباطًا تشعبيًا وبالتالي يمكن استخدامها للانتقال إلى موضع الإدخال الأصلي في المستند باستخدام *Ctrl + Left Click* في Microsoft Word. عند تضمين رمز التبديل هذا، يتم أيضًا الاحتفاظ بهذه الارتباطات بتنسيقات أخرى. على سبيل المثال، في التنسيقات المستندة إلى HTML بما في ذلك EPUB والتنسيقات المعروضة مثل PDF وXPS، سيتم تصديرها كروابط عمل.بدون مفتاح التبديل هذا، سيتم تصدير `TOC` في كل هذه المخرجات كنص عادي ولن يوضح هذا السلوك. إذا تم فتح مستند في برنامج MS Word، فلن يكون نص الإدخالات قابلاً للنقر عليه بهذه الطريقة، ولكن لا يزال من الممكن استخدام أرقام الصفحات للانتقال إلى الإدخال الأصلي.
| | **Set Separator Character***(\P التبديل)* |يسمح رمز التبديل هذا بتغيير المحتوى الذي يفصل بين عنوان الإدخال وترقيم الصفحات بسهولة في جدول المحتويات. يجب تحديد الفاصل الذي سيتم استخدامه بعد رمز التبديل هذا وإحاطته بعلامات الكلام.وبخلاف ما هو موثق في وثائق Office، يمكن استخدام حرف واحد فقط بدلاً من خمسة أحرف كحد أقصى. وينطبق هذا على كل من MS Word وAspose.Words.لا يُنصح باستخدام رمز التبديل هذا لأنه لا يسمح بقدر كبير من التحكم فيما يستخدمه لفصل الإدخالات وأرقام الصفحات في جدول المحتويات. بدلاً من ذلك، يوصى بتحرير النمط `TOC` المناسب مثل `StyleIdentifier.TOC1` ومن هناك تحرير النمط الرئيسي مع إمكانية الوصول إلى أعضاء خط محددين وما إلى ذلك. يمكن العثور على مزيد من التفاصيل حول كيفية القيام بذلك لاحقًا في المقالة.
| | **Preserve Tab Entries***(\W التبديل)* |سيؤدي استخدام رمز التبديل هذا إلى تحديد أنه سيتم الاحتفاظ بأي إدخالات تحتوي على حرف علامة تبويب، على سبيل المثال، عنوان يحتوي على علامة تبويب في نهاية السطر، كحرف علامة تبويب مناسب عند تعبئة جدول المحتويات. وهذا يعني أن وظيفة حرف علامة التبويب ستكون موجودة في `TOC` ويمكن استخدامها لتنسيق الإدخال. على سبيل المثال، قد تستخدم بعض الإدخالات علامات الجدولة وأحرف الجدولة لتباعد النص بشكل متساوٍ. طالما أن المستوى `TOC` المقابل يحدد علامات الجدولة المكافئة، فستظهر إدخالات `TOC` التي تم إنشاؤها بمسافات مماثلة.في نفس الموقف، إذا لم يتم تعريف رمز التبديل هذا، فسيتم تحويل أحرف علامة التبويب إلى مساحة بيضاء مكافئة لعلامات التبويب غير العاملة. ثم لن يظهر الإخراج كما هو متوقع.
| | **Preserve New Line Entries***(\X التبديل)* |كما هو الحال مع رمز التبديل أعلاه، يحدد رمز التبديل هذا أنه سيتم الاحتفاظ بالعناوين الممتدة عبر أسطر متعددة (باستخدام أحرف سطر جديدة وليس فقرات منفصلة) كما هي في جدول المحتويات الذي تم إنشاؤه. على سبيل المثال، يمكن للعنوان الذي سيتم نشره عبر أسطر متعددة استخدام حرف السطر الجديد (Ctrl + Enter أو `ControlChar.LineBreak`) لفصل المحتوى عبر أسطر مختلفة. مع تحديد رمز التبديل هذا، سيحتفظ الإدخال في `TOC` بأحرف السطر الجديدة هذه كما هو موضح أدناه.في هذه الحالة، إذا لم يتم تعريف المفتاح، فسيتم تحويل أحرف السطر الجديد إلى مسافة بيضاء واحدة.
| ## أدخل حقول TC يمكنك إدراج حقل TC جديد في الموضع الحالي لـ [DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) عن طريق استدعاء طريقة [DocumentBuilder.insert_field](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/insert_field/) وتحديد اسم الحقل كـ "TC" مع أي مفاتيح مطلوبة. يوضح المثال أدناه كيفية إدراج حقل `TC` في المستند باستخدام [DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/). {{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-Working with Document-add_content_using_document_builder-InsertTCField.py" >}} ## تعديل جدول المحتويات لا يستخدم تنسيق الإدخالات في `TOC` الأنماط الأصلية للإدخالات المحددة، وبدلاً من ذلك يتم تنسيق كل مستوى باستخدام نمط `TOC` مكافئ. على سبيل المثال، يتم تنسيق المستوى الأول في `TOC` بنمط **جدول المحتويات1**، ويتم تنسيق المستوى الثاني بنمط **TOC2**، وهكذا. وهذا يعني أنه لتغيير مظهر `TOC` يجب تعديل هذه الأنماط. في Aspose.Words، يتم تمثيل هذه الأنماط بواسطة لغة [StyleIdentifier.TOC1](https://reference.aspose.com/words/python-net/aspose.words/styleidentifier/#toc1) المستقلة حتى [StyleIdentifier.TOC9](https://reference.aspose.com/words/python-net/aspose.words/styleidentifier/#toc9) ويمكن استرجاعها من مجموعة [Document.styles](https://reference.aspose.com/words/python-net/aspose.words/documentbase/styles/) باستخدام هذه المعرفات. بمجرد استرداد النمط المناسب للمستند، يمكن تعديل التنسيق لهذا النمط. ستنعكس أي تغييرات يتم إجراؤها على هذه الأنماط تلقائيًا على جداول المحتويات في المستند. يوضح المثال أدناه خاصية التنسيق المستخدمة في نمط `TOC` للمستوى الأول. {{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-Contents Management-working_with_table_of_content-ChangeStyleOfTOCLevel.py" >}} ومن المفيد أيضًا ملاحظة أن أي تنسيق مباشر لفقرة (محددة في الفقرة نفسها وليس في النمط) تم وضع علامة عليها لتضمين `TOC` سيتم نسخه في الإدخال الموجود في جدول المحتويات. على سبيل المثال، إذا تم استخدام نمط العنوان 1 لوضع علامة على محتوى `TOC` وكان لهذا النمط تنسيق غامق بينما تحتوي الفقرة أيضًا على تنسيق مائل مطبق عليها مباشرة. لن يكون إدخال `TOC` الناتج غامقًا لأنه جزء من تنسيق النمط ولكنه سيكون مائلًا لأنه يتم تنسيقه مباشرة على الفقرة. يمكنك أيضًا التحكم في تنسيق الفواصل المستخدمة بين كل إدخال ورقم الصفحة. افتراضيًا، يكون هذا خطًا منقطًا يمتد عبر ترقيم الصفحات باستخدام حرف علامة جدولة وعلامة جدولة على اليمين بالقرب من الهامش الأيمن. باستخدام فئة [Style](https://reference.aspose.com/words/python-net/aspose.words/style/) التي تم استردادها لمستوى `TOC` المحدد الذي تريد تعديله، يمكنك أيضًا تعديل كيفية ظهورها في المستند. لتغيير كيفية ظهور هذا أولاً، يجب استدعاء [Style.paragraph_format](https://reference.aspose.com/words/python-net/aspose.words/style/paragraph_format/) لاسترداد تنسيق الفقرة للنمط. من هذا يمكن استرداد علامات الجدولة عن طريق استدعاء [ParagraphFormat.tab_stops](https://reference.aspose.com/words/python-net/aspose.words/paragraphformat/tab_stops/) وتعديل علامة الجدولة المناسبة. باستخدام هذه التقنية نفسها، يمكن نقل علامة التبويب نفسها أو إزالتها معًا. يوضح المثال أدناه كيفية تعديل موضع علامة التبويب اليمنى في الفقرات ذات الصلة بـ `TOC`. {{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-Contents Management-working_with_table_of_content-ChangeTOCTabStops.py" >}} ## إزالة جدول المحتويات من المستند يمكن إزالة جدول المحتويات من المستند عن طريق إزالة جميع العقد الموجودة بين عقدة [FieldStart](https://reference.aspose.com/words/python-net/aspose.words.fields/fieldstart/) و[FieldEnd](https://reference.aspose.com/words/python-net/aspose.words.fields/fieldend/) لحقل `TOC`. يوضح الكود أدناه هذا. تعد إزالة حقل `TOC` أبسط من الحقل العادي لأننا لا نتتبع الحقول المتداخلة. بدلاً من ذلك، نتحقق من أن عقدة [FieldEnd](https://reference.aspose.com/words/python-net/aspose.words.fields/fieldend/) من النوع [FieldType.FIELD_TOC](https://reference.aspose.com/words/python-net/aspose.words.fields/fieldtype/#field_toc) مما يعني أننا واجهنا نهاية جدول المحتويات الحالي. يمكن استخدام هذه التقنية في هذه الحالة دون القلق بشأن أي حقول متداخلة حيث يمكننا أن نفترض أن أي مستند تم تشكيله بشكل صحيح لن يحتوي على حقل `TOC` متداخل بالكامل داخل حقل `TOC` آخر. أولاً، يتم جمع وتخزين عقد [FieldStart](https://reference.aspose.com/words/python-net/aspose.words.fields/fieldstart/) لكل `TOC`. يتم بعد ذلك تعداد `TOC` المحدد بحيث تتم زيارة جميع العقد داخل الحقل وتخزينها. ثم تتم إزالة العقد من المستند. يوضح نموذج Below code كيفية إزالة `TOC` محدد من مستند. {{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-Contents Management-remove_content-RemoveTOCFromDocument.py" >}} ## استخراج جدول المحتويات إذا كنت تريد استخراج جدول محتويات من أي مستند Word، فيمكن استخدام نموذج التعليمات البرمجية التالي. ```python doc = aw.Document(docs_base.my_dir + "Table of contents.docx") for field in doc.range.fields : if (field.type == aw.fields.FieldType.FIELD_HYPERLINK) : hyperlink = field.as_field_hyperlink() if (hyperlink.sub_address != None and hyperlink.sub_address.find("_Toc") == 0) : tocItem = field.start.get_ancestor(aw.NodeType.PARAGRAPH).as_paragraph() print(tocItem.to_string(aw.SaveFormat.TEXT).strip()) print("------------------") bm = doc.range.bookmarks.get_by_name(hyperlink.sub_address) pointer = bm.bookmark_start.get_ancestor(aw.NodeType.PARAGRAPH).as_paragraph() print(pointer.to_string(aw.SaveFormat.TEXT)) ```