Lucrul cu stiluri și teme

Clasa StyleCollection este utilizată pentru a gestiona setările încorporate și pentru a aplica setările definite de utilizator stilurilor.

Accesarea Stilurilor

Puteți obține o colecție de stiluri definite în document folosind proprietatea Document.styles. Această colecție deține atât stilurile încorporate, cât și cele definite de utilizator într-un document. Un anumit stil ar putea fi obținut prin numele/aliasul său, identificatorul de stil sau indexul său. Următorul exemplu de cod demonstrează cum să obțineți acces la colecția de stiluri definite în document.

Cum să extrageți conținut pe baza stilurilor

La un nivel simplu, preluarea conținutului pe baza stilurilor dintr-un document Word poate fi utilă pentru identificarea, listarea și numărarea paragrafelor și a rulărilor de text formatate cu un anumit stil. De exemplu, poate fi necesar să identificați anumite tipuri de conținut din document, cum ar fi exemple, titluri, referințe, cuvinte cheie, nume de figuri și studii de caz.

Pentru a face acest lucru câțiva pași mai departe, acest lucru poate fi, de asemenea, utilizat pentru a valorifica structura documentului, definită de stilurile pe care le folosește, pentru a reutiliza documentul pentru o altă ieșire, cum ar fi HTML. Acesta este de fapt modul în care este construită documentația Aspose, punând Aspose.Words la încercare. Un instrument construit folosind Aspose.Words ia documentele Word sursă și le împarte în subiecte la anumite niveluri de titlu. Un fișier XML este produs folosind Aspose.Words care este folosit pentru a construi arborele de navigare pe care îl puteți vedea în stânga. Și apoi Aspose.Words convertește fiecare subiect în HTML.

Soluția pentru recuperarea textului formatat cu stiluri specifice într-un document Word este de obicei economică și simplă folosind Aspose.Words.

Soluția

Pentru a ilustra cât de ușor gestionează Aspose.Words preluarea conținutului pe baza stilurilor, să ne uităm la un exemplu. În acest exemplu, vom prelua text formatat cu un anumit stil de paragraf și un stil de caractere dintr-un exemplu de document Word. La un nivel înalt, acest lucru va implica:

  • Deschiderea unui document Word folosind clasa Document.
  • Obținerea colecțiilor tuturor paragrafelor și a tuturor rulărilor din document.
  • Selectarea numai paragrafele necesare și se execută. Mai exact, vom prelua textul formatat cu stilul de paragraf ‘Heading 1 ‘și stilul de caractere ‘intens accent’ din acest exemplu de document Word.

working-with-styles-and-themes-aspose-words-net

În acest exemplu de document, textul formatat cu stilul de paragraf’ Heading 1 ' este ‘Insert Tab’, ' Quick Styles ‘și’ Theme’, iar textul formatat cu stilul de caractere' Intense accounts ‘este format din mai multe instanțe de text Albastru, cursiv, aldin, cum ar fi’ galerii ‘și’look general’.

Codul

Implementarea unei interogări bazate pe stil este destul de simplă în modelul obiectului document Aspose.Words, deoarece folosește pur și simplu instrumente care sunt deja în vigoare. Pentru această soluție sunt implementate două metode de clasă:

  • paragraphs_by_style_name - această metodă preia o serie de paragrafe din document care au un nume de stil specific.
  • runs_by_style_name - această metodă preia o matrice a acelor rulări din document care au un nume de stil specific. Ambele metode sunt foarte similare, singurele diferențe fiind tipurile de noduri și reprezentarea informațiilor de stil în cadrul nodurilor paragraf și run. Iată o implementare a paragraphs_by_style_name: exemplul de mai jos găsiți toate paragrafele formatate cu stilul specificat.

De asemenea, merită subliniat faptul că colecția paragrafe nu creează o cheltuială imediată, deoarece paragrafele sunt încărcate în această colecție numai atunci când accesați articole din ele. Apoi, tot ce trebuie să faceți este să Parcurgeți colecția, folosind operatorul standard foreach și să adăugați paragrafe care au stilul specificat la matricea paragraphs_with_style. Numele stilului Paragraph poate fi găsit în proprietatea Style.name a obiectului Paragraph.paragraph_format. Implementarea runs_by_style_name este aproape aceeași, deși evident folosim NodeType.RUN pentru a prelua nodurile run. Proprietatea Font.style a unui obiect Run este utilizată pentru a accesa informații de stil în nodurile Run. Exemplul de mai jos găsiți toate rulările formatate cu stilul specificat.

Când ambele interogări sunt implementate, tot ce trebuie să faceți este să treceți un obiect document și să specificați numele stilului conținutului pe care doriți să îl preluați: mai jos exemplu rulați interogări și afișați rezultatele. Puteți descărca fișierul șablon al acestui exemplu din aici.

Rezultatul Final

Când totul se face, rularea eșantionului va afișa următoarea ieșire:

styles-and-themes-aspose-words-net

După cum puteți vedea, acesta este un exemplu foarte simplu, care arată numărul și textul paragrafelor colectate și rulează în documentul Word eșantion.

Copiați toate stilurile din șablon

Există cazuri în care doriți să copiați toate stilurile dintr-un document în altul. Puteți utiliza metoda Document.copy_styles_from_template pentru a copia stiluri din șablonul specificat într-un document. Când stilurile sunt copiate dintr-un șablon într-un document, stilurile cu nume similare din document sunt redefinite pentru a se potrivi descrierilor de stil din șablon. Stilurile unice din șablon sunt copiate în document. Stilurile unice din document rămân intacte. Below code exemplu arată cum să copiați stiluri dintr-un document în altul.

Cum să manipulați proprietățile temei

Am adăugat basic API în Aspose.Words pentru a accesa proprietățile temei documentului. Pentru moment, acest API include următoarele obiecte publice:

Iată cum puteți obține proprietăți tematice:

Iată cum puteți seta proprietățile temei:

Găsiți și înlocuiți în Python Lucrul cu secțiuni în Python