Prezentare generală a constructorului de documente
DocumentBuilder este o clasă puternică care se asociază cu Document și îți permite să construiești documente dinamice de la început sau să adaugi noi elemente unui document existent.
DocumentBuilder oferă metode pentru inserarea textului, a casetelor de selectare, obiectelor OLE, paragrafelor, listelor, tabelelor, imaginilor și altor elemente de conținut. Îți permite să specifici fonturi, formatare a paragrafelor sau secțiuni și alte operații.
Construitor de documente sau Aspose.Words DOM
DocumentBuilder completează clase și metode disponibile în Aspose.Words Document Object Model (DOM), pentru a simplifica sarcinile de construire a documentelor cele mai des întâlnite. “adică, poţi crea şi modifica conţinutul documentelor atât prin intermediul Aspose.Words DOM, ceea ce necesită o bună înţelegere a structurii arborescente, cât şi folosind DocumentBuilder-ul.” The DocumentBuilder este un “față” pentru structura complexă Document, care îți permite să introduci rapid și ușor conținut și formatare.
Operații care sunt posibile cu DocumentBuilder sunt și posibil atunci când se utilizează clasele din Aspose.Words DOM direct. Însă folosind Aspose.Words DOM direct de obicei necesită mai multe linii de cod decât folosind DocumentBuilder.
Navigare document
Navigarea documentelor se bazează pe conceptul unui cursor virtual, cu care puteți muta la o altă locație în document folosind diverse DocumentBuilder.MoveToXXX metode precum MoveToDocumentStart și MoveToField. Acest cursor virtual indică locul unde va fi introdus textul atunci când se apelează metodele Write, Writeln, InsertBreak și altele. Vedeți articolul următor “Navigarea cu Cursor” pentru a afla mai multe despre cursorul virtual.
Exemplul de cod următor arată cum să navighezi către un bookmark:
Construirea şi modificarea documentelor
Aspose.Words API oferă mai multe clase care sunt responsabile de formatarea diverselor elemente dintr-un document. Fiecare dintre clase încapsulează proprietăți de formatare legate de un anumit element de document, cum ar fi textul, paragraful, secțiunea și altele. De exemplu, clasa Font reprezintă proprietățile de formatare a caracterelor, clasa ParagraphFormat reprezintă proprietățile de formatare a paragrafelor și așa mai departe. Obiectele acestor clase sunt returnate de proprietățile corespunzătoare DocumentBuilder, care au aceleași nume ca și clasele respective. Prin urmare, puteți accesa și seta formatarea dorită în timpul construcției documentului.
“Poţi introduce, de asemenea, text, casete de selectare, obiecte OLE, imagini, semnale, câmpuri de formular și alte elemente ale documentului la poziția cursorului folosind metoda Write sau oricare dintre metodele DocumentBuilder.InsertXXX, cum ar fi InsertField, InsertHtml și metode similare.”
Să vedem cum se creează un document simplu folosind DocumentBuilder.
Creează un document folosind DocumentBuilder
Pentru a începe trebuie să creezi un DocumentBuilder și să îl asociezi cu un obiect Document. Tu creezi o instanță nouă de DocumentBuilder prin apelarea constructorului său și îi treci în obiectul Document pentru atașare la constructor.
Pentru a insera un text, transmiteți șirul de caractere pe care doriți să-l introduceți în document către metoda Write.
Exemplul de cod următor arată cum să creezi un document simplu folosind un constructor de documente.
Specificaţi formatarea documentului
Proprietatea Font definește formatarea textului. Acest obiect conține diferite atribute de tip de font (nume font, dimensiune font, culoare și așa mai departe). Unele atribute importante de font sunt reprezentate și de proprietăți DocumentBuilder pentru a vă permite să le accesați direct. Acestea sunt proprietățile booleene Font.Bold, Font.Italic și Font.Underline.
Exemplul următor de cod arată cum să inserați un text formatat folosind DocumentBuilder:
- Font specifică formatarea caracterelor care vor fi aplicate tuturor textelor inserate din poziția curentă a documentului în continuare.
- ParagraphFormat specifică formatarea paragrafelor pentru paragraful curent și toate paragrafele care urmează să fie inserate.
- PageSetup specifică proprietățile paginii și secțiunii pentru secțiunea curentă și întreaga secțiune care va fi inserată.
- CellFormat și RowFormat specifică proprietăți de formatare care vor fi aplicate la celulele și rândurile din tabel începând cu poziția curentă în document.
În această situație, “curent” înseamnă poziția, paragraf, secțiune, celulă sau rând în care se află cursorul.