Lucrul cu secțiuni
Uneori doriți un document care nu are aceeași formatare pe toate paginile. De exemplu, poate fi necesar să modificați formatele numărului de pagină, să aveți dimensiuni și orientări diferite ale paginii sau să aveți prima pagină a documentului ca pagină de copertă fără nicio numerotare. Puteți realiza acest lucru cu secțiuni.
Secțiunile sunt noduri de nivel care controlează anteturile și subsolurile, orientarea, coloanele, marginile, formatarea numărului de pagină și altele.
Aspose.Words vă permite să gestionați secțiuni, să împărțiți un document în secțiuni și să efectuați modificări de formatare care se aplică numai unei anumite secțiuni. Aspose.Words stochează informații despre formatarea secțiunii, cum ar fi anteturile și subsolurile, configurarea paginii și setările coloanei în pauza de secțiune.
Acest articol explică cum să lucrați cu secțiuni și pauze de secțiune.
Ce secțiune și pauză de secțiune este
Secțiunile documentului sunt reprezentate de clasele Section și SectionCollection. Obiectele secțiunii sunt copii imediati ai nodului Document și pot fi accesate prin proprietatea Sections. Puteți gestiona aceste noduri utilizând unele metode, cum ar fi Remove, Add, IndexOf, și altele.
Pauza de secțiune este o opțiune care împarte paginile documentelor în secțiuni cu machete personalizabile.
Tipuri de pauză de secțiune
Aspose.Words vă permite să împărțiți și să formatați documente folosind diferite pauze de secțiune ale enumerării BreakType:
- SectionBreakContinuous
- SectionBreakNewColumn
- SectionBreakNewPage
- SectionBreakEvenPage
- SectionBreakOddPage
De asemenea, puteți utiliza enumerarea SectionStart pentru a alege un tip de pauză care se aplică numai pentru prima secțiune, cum ar fi NewColumn, NewPage, EvenPage, și OddPage.
Gestionarea unei secțiuni
Deoarece o secțiune este un nod compus normal, întreaga manipulare a nodului API poate fi utilizată pentru a manipula secțiuni: pentru a adăuga, elimina și alte operații pe secțiuni. Puteți citi mai multe despre noduri în articol Aspose.Words Model Obiect Document (DOM).
Pe de altă parte, puteți utiliza și DocumentBuilder API pentru a lucra cu secțiuni. În acest articol, ne vom concentra asupra acestui mod special de a lucra cu secțiuni.
Introduceți sau eliminați o pauză de secțiune
Aspose.Words vă permite să inserați o pauză de secțiune în text folosind metoda InsertBreak.
Următorul exemplu de cod arată cum să inserați o pauză de secțiune într-un document:
Utilizați metoda Remove pentru a șterge o pauză de secțiune. Dacă nu este necesar să eliminați o anumită pauză de secțiune și, în schimb, să ștergeți conținutul acelei secțiuni, puteți utiliza metoda ClearContent.
Următorul exemplu de cod arată cum să eliminați pauzele de secțiuni:
Mutați o secțiune
Dacă doriți să mutați o secțiune dintr-o poziție în alta în documentul dvs., trebuie să obțineți indexul acelei secțiuni. Aspose.Words vă permite să obțineți o poziție secțiune de la un SectionCollection. Puteți utiliza proprietatea Sections pentru a obține toate secțiunile din documentul dvs. Dar dacă doriți să obțineți doar prima secțiune, puteți utiliza proprietatea FirstSection.
Următorul exemplu de cod arată cum să accesați prima secțiune și să iterați prin copiii unui nod compus:
Specificați un aspect de secțiune
Uneori doriți ca documentul dvs. să arate mai bine făcând machete creative pentru diferite secțiuni de documente. Dacă doriți să specificați tipul grilei de secțiuni curente, puteți alege un mod de aspect al secțiunii utilizând enumerarea SectionLayoutMode:
- Implicit
- Rețea
- LineGrid
- SnapToChars
Următorul exemplu de cod arată cum să limitați numărul de linii pe care le poate avea fiecare pagină:
Editarea unei secțiuni
Când adăugați o nouă secțiune la documentul dvs., nu va exista niciun corp sau paragraf pe care să îl puteți edita. Aspose.Words vă permite să garantați că o secțiune conține un corp cu cel puțin un paragraf folosind metoda EnsureMinimum – va adăuga automat un corp (sau HeaderFooter) nod la document și apoi va adăuga un paragraf la acesta.
Următorul exemplu de cod arată cum să pregătiți un nou nod de secțiune folosind EnsureMinimum:
Adăugați sau Prepend conținut
Dacă doriți să desenați o formă sau să adăugați text sau imagine la începutul/sfârșitul unei secțiuni, puteți utiliza metodele AppendContent și PrependContent ale clasei Section.
Următorul exemplu de cod arată cum să adăugați conținutul unei secțiuni existente:
Clonează o secțiune
Aspose.Words vă permite să duplicați o secțiune creând o copie completă a acesteia folosind metoda Clone.
Următorul exemplu de cod arată cum să clonați prima secțiune din document:
Copiați secțiuni între documente
În unele cazuri, este posibil să aveți documente mari cu multe secțiuni și doriți să copiați conținutul unei secțiuni dintr-un document în altul.
Aspose.Words vă permite să copiați secțiuni între documente folosind metoda ImportNode.
Următorul exemplu de cod arată cum să copiați secțiuni între documente:
Lucrați cu antetul și subsolul secțiunii
Regulile de bază pentru afișarea unui antet sau subsol pentru fiecare secțiune sunt destul de simple:
- Dacă Secțiunea nu are propriile anteturi/subsoluri de un anumit tip, atunci este preluată din secțiunea anterioară.
- Tipul de antet / subsol afișat pe pagină este controlat de setările secțiunii “Different First Page” și “Different Odd & Even pages” – dacă sunt dezactivate, atunci titlurile proprii ale secțiunii sunt ignorate.
Următorul exemplu de cod arată cum să creați 2 secțiuni cu anteturi diferite:
Dacă doriți să eliminați textul anteturilor și subsolurilor fără a elimina obiectele HeaderFooter din documentul dvs., puteți utiliza metoda ClearHeadersFooters. În plus, puteți utiliza metoda DeleteHeaderFooterShapes pentru a elimina toate formele din anteturi și subsoluri din documentul dvs.
Următorul exemplu de cod arată cum să ștergeți conținutul tuturor anteturilor și subsolurilor dintr-o secțiune:
Următorul exemplu de cod cum să eliminați toate formele din toate anteturile subsoluri într-o secțiune:
Personalizați proprietățile paginii într-o secțiune
Înainte de a imprima o pagină sau un document, poate doriți să personalizați și să modificați dimensiunea și aspectul unei singure pagini sau al întregului document. Cu page setup, puteți modifica setările paginilor de documente, cum ar fi marginile, orientarea și dimensiunea pentru imprimarea diferitelor prime pagini sau pagini impare.
Aspose.Words vă permite să personalizați proprietățile paginii și secțiunii Folosind clasa PageSetup.
Următorul exemplu de cod arată cum să setați proprietăți precum dimensiunea paginii și orientarea pentru secțiunea curentă:
Următorul exemplu de cod arată cum să modificați proprietățile paginii în toate secțiunile: