Document Builder Prezentare Generală
DocumentBuilder este o clasă puternică care se asociază cu Document și vă permite să construiți documente dinamice de la zero sau să adăugați elemente noi la unul existent.
DocumentBuilder
Document Builder sau Aspose.Words DOM
DocumentBuilder
Operațiile care sunt posibile cu DocumentBuilder sunt, de asemenea, posibile atunci când se utilizează direct clasele Aspose.Words DOM. Cu toate acestea, utilizarea directă a claselor Aspose.Words DOM necesită de obicei mai multe linii de cod decât utilizarea DocumentBuilder.
Navigare Documente
Navigarea documentelor se bazează pe conceptul de cursor virtual, cu ajutorul căruia vă puteți muta într-o altă locație din document folosind diferite metode DocumentBuilder.MoveToXXX, cum ar fi MoveToDocumentStart și MoveToField. Acest cursor virtual indică unde va fi inserat textul la apelarea metodelor Write, Writeln, InsertBreak, și altele. Consultați următorul articol “navigare cu Cursor” pentru a afla mai multe despre cursorul virtual.
Următorul exemplu de cod arată cum să navigați la un marcaj:
Construirea și modificarea documentelor
Aspose.Words API oferă mai multe clase care sunt responsabile pentru formatarea diferitelor elemente ale unui document. Fiecare dintre clase încapsulează proprietăți de formatare legate de un anumit element de document, cum ar fi text, paragraf, secțiune ș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. Prin urmare, le puteți accesa și seta formatarea dorită în timpul construirii documentului.
De asemenea, puteți insera text, checkbox, obiect ole, imagini, marcaje, câmpuri de formular și alte elemente de document în poziția cursorului folosind metoda Write sau oricare dintre metodele DocumentBuilder.InsertXXX, cum ar fi InsertField, InsertHtml și metode similare.
Să vedem cum să creăm un document simplu folosind DocumentBuilder.
Creați un Document folosind DocumentBuilder
Pentru a începe, trebuie să creați un DocumentBuilder și să îl asociați cu un obiect Document. Creați o nouă instanță de DocumentBuilder apelând constructorul său și o transmiteți unui obiect Document pentru atașare la constructor.
Pentru a insera un text, treceți șirul de text pe care trebuie să îl inserați în document la metoda Write.
Următorul exemplu de cod arată cum să creați un document simplu folosind un constructor de documente.
Specificați Formatarea Documentului
Proprietatea Font definește formatarea textului. Acest obiect conține atribute de font diferite (numele fontului, dimensiunea fontului, culoarea și așa mai departe). Unele atribute importante ale fontului sunt, de asemenea, reprezentate de DocumentBuilder proprietăți pentru a vă permite să le accesați direct. Acestea sunt proprietățile booleene Font.Bold, Font.Italic și Font.Underline.
Următorul exemplu de cod arată cum să inserați un text formatat folosind DocumentBuilder:
- Font specifică formatarea caracterelor care va fi aplicată întregului text inserat începând cu poziția curentă din document.
- ParagraphFormat specifică formatarea paragrafului pentru paragrafele curente și toate paragrafele care trebuie inserate.
- PageSetup specifică proprietățile paginii și secțiunii pentru secțiunea curentă și întreaga secțiune care va fi inserată.
- CellFormat și RowFormat specificați proprietățile de formatare care vor fi aplicate celulelor și rândurilor tabelului începând cu poziția curentă din document.
În această situație," curent " înseamnă poziția, paragraful, secțiunea, celula sau rândul în care se află cursorul.