Werk met Lyste

‘n lys in’n Microsoft Word dokument is’n stel lys formatering eienskappe. Lyste kan in u dokumente gebruik word om teks te formateer, te rangskik en te beklemtoon. Lyste is’n goeie manier om data in dokumente te organiseer, en dit maak dit makliker vir lesers om sleutelpunte te verstaan.

Elke lys kan tot 9 vlakke hê en formatering eienskappe, soos nommer styl, begin waarde, indent, blad posisie ens word afsonderlik vir elke vlak gedefinieer.

In Aspose.Words word die werk met lyste verteenwoordig deur die Lists module. Die List voorwerp behoort egter altyd tot die ListCollection versameling.

Hierdie onderwerp beskryf hoe om programmaties te 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 DocumentBuilder.list_format 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: met kolletjies en genommer.

• Om’n lys met kolletjies te begin, bel ListFormat.apply_bullet_default.
• Om’n genommerde lys te begin, bel ListFormat.apply_number_default.

Die koeël of nommer en formatering word by die huidige paragraaf gevoeg en alle verdere paragrawe word geskep met behulp van DocumentBuilder totdat ListFormat.remove_numbers 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 ListFormat.list_indent
• Om die lysvlak van die huidige paragraaf met een vlak te verlaag, bel ListFormat.list_outdent

Die metodes verander die lys vlak en pas die formatering eienskappe van die nuwe vlak.

U kan ook die ListFormat.list_level_number - eienskap gebruik om die lysvlak vir die paragraaf te kry of in te stel. Die lys vlakke is genommer 0 tot 8.

Hieronder 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 is_restart_at_each_section property 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: