Characters Collection Object

Microsoft Word Visual Basic

Multiple objectsCharacters
Range
Multiple objects

A collection of characters in a selection, range, or document. There is no Character object; instead, each item in the Characters collection is a Range object that represents one character.

Using the Characters Collection

Use the Characters property to return the Characters collection. The following example displays how many characters are selected.

MsgBox Selection.Characters.Count & " characters are selected"
		

Use Characters(index), where index is the index number, to return a Range object that represents one character. The index number represents the position of a character in the Characters collection. The following example formats the first letter in the selection as 24-point bold.

With Selection.Characters(1)
    .Bold = True
    .Font.Size = 24
End With
		

Remarks

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.

An Add method isn't available for the Characters collection. Instead, use the InsertAfter or InsertBefore method to add characters to a Range object. The following example inserts a new paragraph after the first paragraph in the active document.

With ActiveDocument
    .Paragraphs(1).Range.InsertParagraphAfter
    .Paragraphs(2).Range.InsertBefore "New Text"
End With