ListParagraphs Collection Object

See Also         Properties         Methods        

A collection of Paragraph objects that represent the paragraphs of the specified document, list, or range that have list formatting applied.

Using the ListParagraphs Collection

Use the ListParagraphs property to return the ListParagraphs collection. The following example applies highlighting to the collection of paragraphs with list formatting in the active document.

For Each para in ActiveDocument.ListParagraphs
    para.Range.HighlightColorIndex = wdTurquoise
Next para

Use ListParagraphs(index), where index is the index number, to return a single Paragraph object with list formatting.

Remarks

Paragraphs can have two types of list formatting. The first type includes an automatically added number or bullet at the beginning of each paragraph in the list. The second type includes LISTNUM fields, which can be placed anywhere inside a paragraph. There can be more than one LISTNUM field per paragraph.

To add list formatting to paragraphs, you can use the ApplyListTemplate, ApplyBulletDefault, ApplyNumberDefault, or ApplyOutlineNumberDefault method. You access these methods from the ListFormat object for a specified range.

The Count property for this collection in a document returns the number of items in the main story only. To count items in other stories use the collection with the Range object.