ListParagraphs Collection Object

Multiple objects
Multiple objects

A collection of Paragraph objects that represents 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.


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 through 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.

Properties | Application Property | Count Property | Creator Property | Parent Property

Methods | Item Method

Parent Objects | Document | List | Range

Child Objects | Borders | DropCap | ParagraphFormat | Range | Shading | TabStops

See Also | ApplyListTemplate Method