Lucrul cu paragrafele
Un paragraf este o serie de caractere combinate într-un bloc logic și care se termină cu un caracter special - o întrerupere de paragraf. În Aspose.Words, un paragraf este reprezentat de clasa Paragraph.
Introduceți un paragraf
Pentru a introduce un nou paragraf în document, de fapt, ai nevoie să introduci un caracter de pauză de paragraf în el. DocumentBuilder.Writeln nu introduce doar o șir de text în document, ci și adaugă o pauză de paragraf.
“Formatarea curentă a fontului este specificată și de proprietatea Font, iar formatarea curentă a paragrafului este determinată de proprietatea ParagraphFormat.” În secțiunea următoare vom discuta în detaliu despre formatarea paragrafelor.
Exemplul de cod următor arată cum se inserează un paragraf într-un document:
Format Paragraful
Formatarea paragrafelor curente este reprezentată de obiectul ParagraphFormat care este returnat de proprietatea ParagraphFormat. Acest obiect încapsulează diverse proprietăți de formatare a paragrafelor disponibile în Microsoft Word. Puteți reseta cu ușurință formatarea unui paragraf la stilul său implicit – Normal, aliniat spre stânga, fără indentare, fără spațiere, fără margini, fără umbrire – apelând ClearFormatting.
Exemplul de cod următor arată cum să se stabilească formatarea paragrafelor:
Aplică Stilul de Paragraful
Unele obiecte de formatare, cum ar fi Font sau ParagraphFormat, acceptă stiluri. Un stil încorporat sau definit de utilizator este reprezentat de un Style obiect, care conține proprietățile stilului corespunzătoare, cum ar fi numele, stilul de bază, fontul, formatarea paragrafului de stil și așa mai departe.
În plus, obiectul Style expune proprietatea StyleIdentifier, care returnează identificatorul de stil independent de limbă reprezentat de valoarea enumerației StyleIdentifier. Faptul este că numele stilurilor încorporate din Microsoft Word sunt localizate pentru diferite limbi. Folosind identificatorul stilului, puteți găsi stilul corect indiferent de limba documentului. Valorile enumerării corespund stilurilor încorporate, cum ar fi Microsoft Word, cum ar fi Normal, Titluri 1, Titluri 2 și așa mai departe. Toate stilurile definite de utilizator sunt stabilite la valoarea enumerării StyleIdentifier.User.
Exemplul de cod următor arată cum se aplică un stil de paragraful:
Introduce Stil Separator pentru a Separa Stiluri de Paragrafe Diferite
Un separator de stil poate fi adăugat la sfârșitul unui paragraf folosind scurtătura de tastatură Ctrl+Alt+Enter în Microsoft Word. Această caracteristică vă permite să utilizați două stiluri diferite de paragraf în același paragraf logic tipărit. Dacă doriți ca un anumit text de la începutul unui antet specific să apară în tabelul de conținuturi, dar nu doriți ca întregul antet să fie afișat în tabelul de conținuturi, puteți folosi această funcție.
Exemplul de cod următor arată cum se inserează un separator de stil pentru a acomoda diferite stiluri de paragrafe:
Identifică Separatorul Stilului Paragraf
Aspose.Words expune proprietatea publică BreakIsStyleSeparator pe clasa Paragraph pentru a identifica un paragraf cu un separatore de stil, așa cum se vede în exemplul de mai jos:
Aplică margini și umbrire unui paragraf
Bordurile în Aspose.Words sunt reprezentate de clasa BorderCollection – aceasta este o colecție de Border obiecte accesate prin indice sau tip de bordură. Tipul de contur este reprezentat în continuare prin enumerarea BorderType. Unele valori de enumerare se aplică la mai multe sau doar la un singur element de document. De exemplu, BorderType.Bottom se aplică la un paragraf sau o celulă de tabel, în timp ce BorderType.DiagonalDown specifică un contur diagonal într-o celulă de tabel doar.
Atât colecția de borduri, cât și fiecare bordură separată au atribute similare, cum ar fi culoarea, stilul liniei, lățimea liniei, distanța față de text și umbra opțională. Ei sunt reprezentați de proprietăți cu același nume. Poţi obţine tipuri de borduri diferite prin combinarea valorilor proprietăţilor. În plus, obiectele BorderCollection și Border vă permit să resetați aceste valori la valorile lor implicite prin apelarea metodei ClearFormatting.
Aspose.Words are și clasa Shading care conține atribute de umbrire pentru elementele documentului. Puteți seta textura de umbrire dorită și culorile care se aplică la fundalul și la primul plan al unui obiect folosind valoarea enumerării TextureIndex. TextureIndex vă permite, de asemenea, să aplicați diferite modele pentru Shading obiect. De exemplu, pentru a seta culoarea de fundal pentru un element de document, folosiți valoarea TextureIndex.TextureSolid și setați culoarea de umbră în prim plan după cum se potrivește.
Exemplul de cod următor arată cum se aplică borduri și umbrire unui paragraf:
Numără rânduri paragraf
Dacă doriți să numărați numărul de linii dintr-un paragraf pentru orice document Word, codul următor poate fi utilizat: