Lucrul cu marcaje

Marcajele identifică într-un document Microsoft Word locațiile sau fragmentele pe care le denumiți și le identificați pentru referințe viitoare. De exemplu, este posibil să utilizați un marcaj pentru a identifica textul pe care doriți să îl revizuiți ulterior. În loc să derulați documentul pentru a localiza textul, puteți accesa acesta utilizând caseta de dialog marcaj.

Acțiunile care pot fi efectuate cu marcaje folosind Aspose.Words sunt aceleași cu cele pe care le puteți efectua folosind Microsoft Word. Puteți introduce un marcaj nou, șterge, muta la un marcaj, obține sau seta un nume de marcaj, obține sau seta textul inclus în ea. Cu Aspose.Words, puteți utiliza, de asemenea, marcaje în rapoarte sau documente pentru a insera unele date în marcaj sau pentru a aplica formatare specială conținutului acestuia. De asemenea, puteți utiliza marcaje pentru a prelua text dintr-o anumită locație din document.

Introduceți un marcaj

Utilizați start_bookmark și end_bookmark pentru a crea un marcaj marcând începutul și respectiv sfârșitul acestuia. Nu uitați să transmiteți același nume de marcaj la ambele metode. Marcajele dintr-un document se pot suprapune și se pot întinde pe orice interval. Marcajele sau marcajele formate prost cu nume duplicate vor fi ignorate atunci când documentul este salvat.

Toate spațiile albe din marcaje au fost înlocuite cu subliniere. Această restricție a venit din formatele de cuvinte MS, deoarece marcajele în formatele de cuvinte MS, cum ar fi DOCX sau DOC, nu pot avea spații albe. Cu toate acestea, PDF permite astfel de marcaje. Deci, acum, dacă trebuie să utilizați marcaje în contururi PDF sau XPS, le puteți folosi cu spații albe.

Următorul exemplu de cod arată cum să creați un marcaj nou:

Obțineți Marcaje

Uneori este necesar să obțineți o colecție de marcaje pentru a repeta prin marcaje sau în alte scopuri. Utilizați proprietatea Node.range expusă de orice nod de document care returnează un obiect Range reprezentând porțiunea documentului conținută în acest nod. Utilizați acest obiect pentru a prelua un BookmarkCollection și apoi utilizați indexatorul de colectare pentru a obține un marcaj specific.

Puteți descărca fișierul eșantion al acestor exemple din Aspose.Words GitHub.

Următorul exemplu de cod arată cum să obțineți marcaje dintr-o colecție de marcaje:

Următorul exemplu de cod arată cum să obțineți sau să setați un nume de marcaj și un text:

Următorul exemplu de cod arată cum să marcați un tabel:

Dacă schimbați numele unui marcaj într-un nume care există deja în document, nu va fi generată nicio eroare și numai primul marcaj va fi stocat atunci când salvați documentul.

Rețineți că unele marcaje din document sunt atribuite câmpurilor de formular. Trecerea la un astfel de marcaj și introducerea textului acolo introduce textul în codul câmpului formularului. Deși acest lucru nu va invalida câmpul Formular, textul inserat nu va fi vizibil deoarece devine parte a codului câmpului.

Următorul exemplu de cod arată cum să accesați coloanele tabelului marcat:

Trecerea la un marcaj

Dacă trebuie să inserați conținut bogat (nu doar text simplu) într-un marcaj, ar trebui să utilizați move_to_bookmark pentru a muta cursorul la marcaj și apoi să utilizați DocumentBuilder’s Metode și proprietăți pentru a insera conținut.

Afișați Conținutul De Ascundere A Marcajelor

Întregul marcaj (including the bookmarked content) poate fi încapsulat în partea adevărată a câmpului IF Folosind Aspose.Words. Poate fi în așa fel încât câmpul IF să conțină un câmp de îmbinare imbricat în Expresie (Left of Operator) și în funcție de valoarea câmpului de îmbinare, câmpul IF arată sau ascunde conținutul marcajului în documentul Word.

Următorul exemplu de cod arată cum să afișați / ascundeți marcajele: