Werk met Lyste
‘n lys in’n Microsoft Word dokument is’n stel paragraaf formatering eienskappe. Lyste kan in dokumente gebruik word om teks te struktureer, te rangskik en te beklemtoon. Lyste is’n goeie manier om data in dokumente te organiseer op’n manier wat dit vir lesers maklik maak om sleutelpunte te absorbeer en te verstaan.
Elke lys kan tot 9 vlakke hê, en formatering eienskappe soos nommer styl, begin waarde, inkeping, blad posisie, en ander word afsonderlik vir elke vlak gedefinieer.
In Aspose.Words word die werk met lyste verteenwoordig deur die Lists naamruimte. Die List voorwerp behoort egter altyd aan die ListCollection.
Hierdie artikel beskryf programmaties werk met lyste met behulp van Aspose.Words.
Skep Lyste Deur Lysformatering Toe Te Pas
Aspose.Words laat die maklike skepping van lyste toe deur lysformatering toe te pas. DocumentBuilder verskaf die ListFormat eienskap wat’n ListFormat voorwerp terugkeer. Hierdie voorwerp het verskeie metodes om’n lys te begin en te beëindig en om die inkeping te verhoog/verminder. Daar is twee algemene tipes lyste in Microsoft Word: bullet en genommer:
- Om’n lys met kolletjies te begin, bel ApplyBulletDefault
- Om’n genommerde lys te begin, bel ApplyNumberDefault
Die koeël of nommer en formatering word by die huidige paragraaf gevoeg en alle verdere paragrawe word geskep met behulp van DocumentBuilder totdat RemoveNumbers geroep word om die formatering van die lys met kolletjies te stop.
In Word-dokumente kan lyste uit tot nege vlakke bestaan. Lys opmaak vir elke vlak spesifiseer watter koeël of nommer gebruik word, links inkeping, spasie tussen die koeël en teks ens. Die volgende metodes verander die lys vlak en pas die nuwe vlak se formatering eienskappe:
- Om die lysvlak van die huidige paragraaf met een vlak te verhoog, bel ListIndent
- Om die lysvlak van die huidige paragraaf met een vlak te verlaag, bel ListOutdent
U kan ook die ListLevelNumber - eienskap gebruik om die lysvlak vir die paragraaf te kry of in te stel.
Die volgende kode voorbeeld toon hoe om’n multilevel lys te bou:
Spesifiseer Formatering vir’n Lysvlak
Lys-vlak voorwerpe word outomaties geskep wanneer’n lys geskep word. Gebruik die eienskappe en metodes van die ListLevel klas om die formatering van individuele vlakke van’n lys te beheer.
Herbegin Lys vir elke Afdeling
Jy kan’n lys vir elke afdeling herbegin deur die IsRestartAtEachSection eienskap te gebruik. Let daarop dat hierdie opsie slegs in RTF, DOC en DOCX dokumentformate ondersteun word. Hierdie opsie sal slegs in DOCX geskryf word as OoxmlCompliance hoër is as Ecma376.
Die volgende kode voorbeeld toon hoe om’n lys te skep en herlaai dit vir elke afdeling: