Lucrul cu paragrafe

Un paragraf este un set de caractere combinate într – un bloc logic și se termină cu un caracter special-a paragraph break. În Aspose.Words, un paragraf este reprezentat de clasa Paragraph.

Introduceți un paragraf

Pentru a insera un nou paragraf în document, de fapt, trebuie să introduceți un caracter de rupere a paragrafului în el. DocumentBuilder.writeln inserează și un șir de text în document, dar în plus, adaugă o pauză de paragraf.

Formatarea fontului curent este, de asemenea, specificată de proprietatea font, iar formatarea paragrafului curent este determinată de proprietatea paragraph_format.

Următorul exemplu de cod arată cum să inserați un paragraf într-un document:

Format Paragraf

Formatarea paragrafului curent este reprezentată de un obiect ParagraphFormat Care este returnat de proprietatea paragraph_format. Acest obiect încapsulează diferite proprietăți de formatare a paragrafelor disponibile în Microsoft Word. Puteți reseta cu ușurință formatarea paragrafului la implicit la stilul Normal, aliniat la stânga, fără indentare, fără spațiere, fără margini și fără umbrire apelând clear_formatting.

Următorul exemplu de cod arată cum să setați formatarea paragrafului:

Aplicați un stil de paragraf

Unele obiecte de formatare, cum ar fi Font sau ParagraphFormat, acceptă stiluri. Un singur stil încorporat sau definit de utilizator este reprezentat de un obiect Style care conține proprietățile stilului corespunzătoare, cum ar fi numele, stilul de bază, fontul și formatarea paragrafului stilului și așa mai departe.

Mai mult, un obiect Style furnizează proprietatea Style.style_identifier care returnează un identificator de stil independent de localizare reprezentat de o valoare de enumerare StyleIdentifier. Ideea este că numele stilurilor încorporate în Microsoft Word sunt localizate pentru diferite limbi. Folosind un identificator de stil, puteți găsi stilul corect indiferent de limba documentului. Valorile de enumerare corespund stilurilor încorporate Microsoft Word, cum ar fi Normal, Heading 1, Heading 2 etc. Tuturor stilurilor definite de utilizator li se atribuie valoarea StyleIdentifier.USER.

Următorul exemplu de cod arată cum se aplică un stil de paragraf:

Inserați Separator de stil pentru a pune diferite stiluri de paragraf

Un separator de stil poate fi adăugat la sfârșitul unui paragraf folosind comanda rapidă de la tastatură Ctrl + Alt + Enter în MS Word. Această caracteristică permite două stiluri diferite de paragraf utilizate într-un paragraf tipărit logic. Dacă doriți ca un text de la începutul unui anumit titlu să apară într-un cuprins, dar nu doriți ca întregul titlu să apară în Cuprins, puteți utiliza această caracteristică.

Următorul exemplu de cod arată cum să inserați un separator de stil pentru a se potrivi diferitelor stiluri de paragraf:

Identificați Separatorul De Stil De Paragraf

Aspose.Words oferă o proprietate publică break_is_style_separator într-o clasă Paragraph permite identificarea paragrafului Separator de stil, așa cum se arată în exemplul de mai jos:

Aplicați margini și umbrire la un paragraf

Frontierele sunt reprezentate de BorderCollection. Aceasta este o colecție de obiecte Border care sunt accesate prin index sau prin tipul de frontieră. Tipul de frontieră este reprezentat de enumerarea BorderType. Unele valori ale enumerării sunt aplicabile mai multor sau unui singur element de document. De exemplu, BorderType.BOTTOM este aplicabil unui paragraf sau unei celule de tabel, în timp ce BorderType.DIAGONALDOWN specifică marginea diagonală numai într-o celulă de tabel.

Atât colecția de chenar, cât și fiecare chenar separat au atribute similare, cum ar fi culoarea, stilul liniei, lățimea liniei, distanța față de text și umbra opțională. Ele sunt reprezentate de proprietăți cu același nume. Puteți obține diferite tipuri de margini combinând valorile proprietății. În plus, ambele obiecte BorderCollection și Border vă permit să resetați aceste valori la valorile implicite apelând metoda Border.clear_formatting.

Aspose.Words are, de asemenea, clasa Shading conține atribute de umbrire pentru elementele documentului. Puteți seta textura de umbrire dorită și culorile care sunt aplicate pe fundalul și prim-planul elementului.

Textura de umbrire este setată cu o valoare de enumerare TextureIndex care permite aplicarea diferitelor modele obiectului Shading. De exemplu, pentru a seta o culoare de fundal pentru un element de document, utilizați valoarea TextureIndex.TEXTURE_SOLID și setați culoarea de umbrire în prim plan, după caz. Exemplul de mai jos arată cum să aplicați margini și umbrire la un paragraf.

Următorul exemplu de cod arată cum să aplicați margini și umbrire unui paragraf: