ListValue Property

Returns the numeric value of the first paragraph in the range for the specified ListFormat object. For example, the ListValue property applied to the second paragraph in an alphabetic list would return 2. Read-only Long.

expression.ListValue

expression Required. An expression that returns a ListFormat object.

Remarks

Use the ListString property to return a string that represents the list value.

If the ListFormat object applies to a bulleted list, the ListValue property returns 1.

If the ListFormat object applies to an outline-numbered list, the ListValue property returns the numeric value of the first paragraph as it occurs in the sequence of paragraphs at the same level. For example, if the first paragraph for a specified ListFormat object were numbered "A.2," the ListValue would return 2.

This property will not return the value for a LISTNUM field.

Example

This example displays both the numeric value of the first paragraph in the selection and the string representation of that value.

v = Selection.Range.ListFormat.ListValue
lstring = Selection.Range.ListFormat.ListString
MsgBox "List value " & v _
    & " is represented by the string " & lstring

Applies to | ListFormat Object

See Also | ListString Property