Table of contents
Collapse the table of content
Expand the table of content

TextRange.Characters Method (Publisher)

office 365 dev account|Last Updated: 8/24/2017
3 Contributors

Returns a TextRange object that represents the specified subset of text characters.


expression. Characters( Start, Length)

_expression_A variable that represents a TextRange object.


NameRequired/OptionalData TypeDescription
StartRequiredLongThe first character in the returned range.
LengthOptionalLongThe number of characters to be returned. Default is 1.

Return Value



If Start is greater than the number of characters in the specified text, the returned range starts with the last character in the specified range.

If Length is greater than the number of characters from the specified starting character to the end of the text, the returned range contains all those characters.


This example sets the text for the first shape on the first page in the active document, and then sets the font of the first two characters to 15 points and bold.

Sub CharRange() 
 Dim rngCharacters As TextRange 
 Set rngCharacters = Application.ActiveDocument.Pages(1).Shapes(1) _ 
 .TextFrame.TextRange.InsertBefore(NewText:="Hello World.") 
 With rngCharacters.Characters(Start:=1, Length:=2).Font 
 .Size = 15 
 .Bold = msoTrue 
 End With 
End Sub
© 2018 Microsoft