Acest comutator definește că `TOC` ar trebui să fie construit din stilurile de titlu încorporate. În Microsoft Word acestea sunt definite de Heading 1 - Heading 9. În Aspose.Words aceste stiluri sunt reprezentate de enumerarea corespunzătoare StyleIdentifier. Această enumerare reprezintă un identificator independent de localizare al unui stil, de exemplu `StyleIdentifier.Heading1` reprezintă stilul Heading 1. Folosind acest lucru, formatarea și proprietățile stilului pot fi preluate din colecția de stil a documentului. Clasa de stil corespunzătoare poate fi recuperată din colecția `Document.Styles` utilizând proprietatea indexată de tip StyleIdentifier.
Orice conținut formatat cu aceste stiluri este inclus în cuprins. Nivelul titlului va defini nivelul ierarhic corespunzător al intrării din TOC. De exemplu, un paragraf cu stilul Heading 1 va fi tratat ca primul nivel din `TOC`, în timp ce un paragraf cu Heading 2 va fi tratat ca următorul nivel din ierarhie și așa mai departe.
| | **Outline Levels** * (\U comutator)* |Fiecare paragraf poate defini un nivel de schiță sub opțiunile paragrafului.
Această setare dictează nivelul la care acest paragraf trebuie tratat în ierarhia documentelor. Aceasta este o practică utilizată în mod obișnuit pentru a structura cu ușurință aspectul unui document. Această ierarhie poate fi vizualizată prin schimbarea la vizualizarea conturului în Microsoft Word. Similar cu stilurile de titlu, pot exista 1 - 9 niveluri de contur în plus față de nivelul" text al corpului". Nivelurile de contur 1 - 9 vor apărea în `TOC` în nivelul corespunzător al ierarhiei Orice conținut cu un nivel de schiță fie stabilit în stilul paragrafului, fie direct pe paragraful în sine este inclus în TOC. În Aspose.Words nivelul conturului este reprezentat de proprietatea `ParagraphFormat.OutlineLevel` a nodului paragraf. Nivelul conturului unui stil de paragraf este reprezentat în același mod de proprietatea `Style.ParagraphFormat`.
```
Rețineți că stilurile de titlu încorporate, cum ar fi Heading 1, au un set obligatoriu de nivel de contur în setările de stil.
```
| | **Custom Styles** * (\T comutator)* |Acest comutator va permite stiluri personalizate pentru a fi utilizate la colectarea intrărilor care urmează să fie utilizate în TOC. Acest lucru este adesea folosit împreună cu comutatorul \o pentru a include stiluri personalizate împreună cu stilurile de titlu încorporate în TOC. Parametrii comutatorului trebuie să fie încadrați în semnele de vorbire. Multe stiluri personalizate pot fi incluse, pentru fiecare stil numele ar trebui specificat urmat de o virgulă urmată de nivelul în care stilul ar trebui să apară în `TOC` ca. Alte stiluri sunt, de asemenea, separate printr-o virgulă. De exemplu
```csharp{ TOC \o "1-3" \t "CustomHeading1, 1, CustomHeading2, 2"}```
va folosi conținut stilat cu CustomHeading1 ca nivel 1 conținut în `TOC` și CustomHeading2 ca nivel 2.
| | **Use TC Fields** * (\F și \ l switch-uri)* |În versiunile mai vechi ale Microsoft Word, singura modalitate de a construi un `TOC` a fost utilizarea câmpurilor TC. Aceste câmpuri sunt inserate ascunse în document chiar și atunci când sunt afișate coduri de câmp. Acestea includ textul care ar trebui să fie afișat în intrare și `TOC` este construit din ele. Această funcționalitate nu este acum utilizată foarte des, dar poate fi totuși utilă în unele ocazii pentru a include intrări în `TOC` care nu sunt indentate pentru a fi vizibile în document. Când sunt inserate, aceste câmpuri apar ascunse chiar și atunci când sunt afișate coduri de câmp. Ele nu pot fi văzute fără a afișa conținut ascuns. Pentru a vedea aceste câmpuri, trebuie selectată formatarea paragrafului.
Aceste câmpuri pot fi inserate într-un document în orice poziție ca orice alt câmp și sunt reprezentate prin enumerarea `FieldType.FieldTOCEntry`. Comutatorul \F din a `TOC` este utilizat pentru a specifica că câmpurile TC ar trebui utilizate ca intrări. Comutatorul singur fără niciun identificator suplimentar înseamnă că orice câmp TC din document va fi inclus. Orice parametru suplimentar, adesea o singură literă, va desemna că numai câmpurile TC care au un comutator \f corespunzător vor fi incluse în TOC. De exemplu *
```csharp{ TOC \f t }```
va include doar TC câmpuri, cum ar fi
```csharp{ TC \f t }```
Câmpul `TOC` are, de asemenea, un comutator asociat, comutatorul "\l" specifică faptul că sunt incluse numai câmpul TC cu niveluri în intervalul specificat.
Câmpurile `TC` în sine pot avea, de asemenea, mai multe comutatoare setate. Acestea sunt:
- * \F-explicat mai sus.*
- * \L-definește în ce nivel din `TOC` va apărea acest câmp TC. Un `TOC` care utilizează același comutator va include acest câmp TC numai dacă se află în intervalul specificat.*
- _\N - numerotarea paginilor pentru această intrare `TOC` nu este afișată.Codul De exemplu al modului de inserare a câmpurilor TC poate fi găsit în secțiunea următoare.
| ### Comutatoare Legate De Aspect | Comutator | Descriere | | :- | :- | | **Omit Page Numbers** * (\N Comutator)* |Acest comutator este folosit pentru a ascunde numerele de pagină pentru anumite niveluri ale TOC. De exemplu, puteți defini
```csharp{TOC \o "1-4" \n "3-4" }```
și numerele de pagină de pe intrările nivelurilor 3 și patru vor fi ascunse împreună cu punctele lider (dacă există). Pentru a specifica un singur nivel, ar trebui să se utilizeze în continuare un interval, de exemplu "1-1" va exclude numerele de pagină numai pentru primul nivel. Furnizarea unui interval de nivel nu va omite numerele de pagină pentru toate nivelurile din TOC. Acest lucru este util pentru a seta atunci când exportați un document în HTML sau în format similar. Acest lucru se datorează faptului că formatele bazate pe HTML nu au niciun concept de pagină și, prin urmare, nu au nevoie de nicio numerotare a paginilor.
| | **Insert As Hyperlinks** * (\H Comutator)* |Acest comutator specifică faptul că intrările `TOC` sunt inserate ca hyperlink-uri. Când vizualizați un document în Microsoft Word, aceste intrări vor apărea în continuare ca text normal în interiorul `TOC`, dar sunt hyperlink-uri și astfel pot fi utilizate pentru a naviga la poziția intrării originale din document folosind *Ctrl + Left Click* în Microsoft Word. Când acest comutator este inclus, aceste legături sunt păstrate și în alte formate. De exemplu, în formate bazate pe HTML, inclusiv EPUB și formate redate, cum ar fi PDF și XPS, acestea vor fi exportate ca legături de lucru. Fără acest comutator setați `TOC` în toate aceste ieșiri vor fi exportate ca text simplu și nu va demonstra acest comportament. Dacă un document este deschis în MS Word, textul intrărilor nu va putea fi făcut clic în acest fel, dar numerele paginilor pot fi utilizate în continuare pentru a naviga la intrarea originală.
| | **Set Separator Character** * (\P Comutator)* |Acest comutator permite ca conținutul care separă titlul intrării și numerotarea paginilor să fie ușor modificat în TOC. Separatorul de utilizat Trebuie specificat după acest comutator și inclus în semne de vorbire. Spre deosebire de ceea ce este documentat în documentația Office, un singur caracter poate fi folosit în loc de până la cinci. Acest lucru se aplică atât MS Word, cât și Aspose.Words. Utilizarea acestui comutator nu este recomandată, deoarece nu permite prea mult control asupra a ceea ce a folosit pentru a separa intrările și numerele de pagină din TOC. În schimb, se recomandă să editați stilul `TOC` corespunzător, cum ar fi `StyleIdentifier.TOC1` și de acolo să editați stilul leader cu acces la anumiți membri ai fontului etc. Mai multe detalii despre cum să faceți acest lucru pot fi găsite mai târziu în articol.
| | **Preserve Tab Entries** * (\W Comutator)* |Utilizarea acestui comutator va specifica că orice intrări care au un caracter de filă, de exemplu un titlu care are o filă la sfârșitul liniei, vor fi păstrate ca un caracter de filă adecvat la popularea TOC. Aceasta înseamnă că funcția caracterului tab va fi prezentă în `TOC` și poate fi utilizată pentru a formata intrarea. De exemplu, anumite intrări pot utiliza tab stopuri și caractere tab pentru a spația uniform textul. Atâta timp cât nivelul corespunzător `TOC` definește tab-ul echivalent se oprește, atunci intrările `TOC` generate vor apărea cu spațiere similară. În aceeași situație, dacă acest comutator nu a fost definit, atunci caracterele tab ar fi convertite în spațiu alb echivalent ca file nefuncționale. Rezultatul nu ar apărea așa cum era de așteptat.
| | **Preserve New Line Entries** * (\X Comutator)* |Similar cu comutatorul de mai sus, acest comutator specifică faptul că titlurile care se întind pe mai multe linii (folosind caractere de linie noi, nu paragrafe separate) vor fi păstrate așa cum sunt în TOC generat. De exemplu, un titlu care urmează să se răspândească pe mai multe linii poate utiliza noul caracter de linie (Ctrl + Enter sau `ControlChar.LineBreak`) pentru a separa conținutul pe diferite linii. Cu acest comutator specificat, intrarea din `TOC` va păstra aceste noi caractere de linie, așa cum se arată mai jos. În această situație, dacă comutatorul nu este definit, atunci noile caractere de linie sunt convertite într-un singur spațiu alb.
| ## Introduceți TC Câmpuri Puteți insera un nou câmp TC în poziția curentă a [DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) apelând metoda [DocumentBuilder.insert_field](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/insert_field/) și specificând numele câmpului ca "TC" împreună cu orice comutatoare necesare. Exemplul de mai jos arată cum să inserați un câmp `TC` în document folosind [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" >}} ## Modificați un cuprins Formatarea intrărilor din `TOC` nu utilizează stilurile originale ale intrărilor marcate, în schimb fiecare nivel este formatat folosind un stil echivalent `TOC`. De exemplu, primul nivel din `TOC` este formatat cu stilul **TOC1**, al doilea nivel formatat cu stilul **TOC2** și așa mai departe. Aceasta înseamnă că pentru a schimba aspectul `TOC` aceste stiluri trebuie modificate. În Aspose.Words aceste stiluri sunt reprezentate de locale independent [StyleIdentifier.TOC1](https://reference.aspose.com/words/python-net/aspose.words/styleidentifier/#toc1) până la [StyleIdentifier.TOC9](https://reference.aspose.com/words/python-net/aspose.words/styleidentifier/#toc9) și pot fi recuperate din colecția [Document.styles](https://reference.aspose.com/words/python-net/aspose.words/documentbase/styles/) folosind acești identificatori. Odată ce stilul corespunzător al documentului a fost preluat, formatarea pentru acest stil poate fi modificată. Orice modificare a acestor stiluri va fi reflectată automat pe TOCs din document. Exemplul de mai jos modifică o proprietate de formatare utilizată în primul nivel `TOC` stil. {{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-Contents Management-working_with_table_of_content-ChangeStyleOfTOCLevel.py" >}} De asemenea, este util să rețineți că orice formatare directă a unui paragraf (definit pe paragraful în sine și nu în stil) marcat pentru a fi inclus `TOC` va fi copiat în intrarea din TOC. De exemplu, dacă stilul Heading 1 este folosit pentru a marca conținutul pentru `TOC` și acest stil are formatare cu caractere aldine, în timp ce paragraful are, de asemenea, formatare cursivă aplicată direct acestuia. Intrarea `TOC` rezultată nu va fi aldină, deoarece face parte din formatarea stilului, dar va fi cursivă, deoarece aceasta este formatată direct în paragraf. De asemenea, puteți controla formatarea separatoarelor utilizate între fiecare intrare și numărul paginii. În mod implicit, aceasta este o linie punctată care este răspândită în numerotarea paginilor folosind un caracter de filă și un stop de filă din dreapta aliniat aproape de marginea din dreapta. Folosind clasa [Style](https://reference.aspose.com/words/python-net/aspose.words/style/) recuperată pentru nivelul `TOC` pe care doriți să îl modificați, puteți modifica și modul în care acestea apar în document. Pentru a schimba modul în care apare mai întâi [Style.paragraph_format](https://reference.aspose.com/words/python-net/aspose.words/style/paragraph_format/) trebuie apelat pentru a prelua formatarea paragrafului pentru stil. Din aceasta, opririle de filă pot fi recuperate prin apelarea [ParagraphFormat.tab_stops](https://reference.aspose.com/words/python-net/aspose.words/paragraphformat/tab_stops/) și oprirea de filă corespunzătoare modificată. Folosind aceeași tehnică, fila în sine poate fi mutată sau eliminată împreună. Exemplul de mai jos arată cum să modificați poziția opritorului de filă din dreapta în `TOC` paragrafe conexe. {{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-Contents Management-working_with_table_of_content-ChangeTOCTabStops.py" >}} ## Eliminați un cuprins din Document Un cuprins poate fi eliminat din document prin eliminarea tuturor nodurilor găsite între nodul [FieldStart](https://reference.aspose.com/words/python-net/aspose.words.fields/fieldstart/) și [FieldEnd](https://reference.aspose.com/words/python-net/aspose.words.fields/fieldend/) din câmpul `TOC`. Codul de mai jos demonstrează acest lucru. Eliminarea câmpului `TOC` este mai simplă decât un câmp normal, deoarece nu ținem evidența câmpurilor imbricate. În schimb, verificăm nodul [FieldEnd](https://reference.aspose.com/words/python-net/aspose.words.fields/fieldend/) este de tip [FieldType.FIELD_TOC](https://reference.aspose.com/words/python-net/aspose.words.fields/fieldtype/#field_toc), ceea ce înseamnă că am întâlnit sfârșitul curentului TOC. Această tehnică poate fi utilizată în acest caz fără a vă îngrijora de câmpurile imbricate, deoarece putem presupune că orice document format corect nu va avea un câmp `TOC` complet imbricat în interiorul unui alt câmp `TOC`. În primul rând, nodurile [FieldStart](https://reference.aspose.com/words/python-net/aspose.words.fields/fieldstart/) ale fiecărui `TOC` sunt colectate și stocate. `TOC` specificat este apoi enumerat astfel încât toate nodurile din câmp sunt vizitate și stocate. Nodurile sunt apoi eliminate din document. Below code eșantion demonstrează cum să eliminați un `TOC` specificat dintr-un document. {{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-Contents Management-remove_content-RemoveTOCFromDocument.py" >}} ## Extras cuprins Dacă doriți să extrageți un cuprins din orice document Word, poate fi utilizat următorul eșantion de cod. ```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)) ```