Characters object

Microsoft Visio Developer Reference

Characters object

           

Shapes (Shape) Characters

Represents a shape's text with the text fields expanded to the number of characters they display in a drawing window.

To retrieve a Characters object, use the Characters property of a Shape object.

Version added

3.0

Remarks

The default property of a Characters object is Text.

The Begin and End properties of a Characters object determine the range of the shape's text that is represented by the Characters object. Initially, the range contains all of the shape's text; you can set the Begin and End properties to specify a subrange of the text.

After you retrieve a Characters object, you can use its Text property to retrieve or set the shape's text. Use the Copy, Cut, or Paste method to copy, cut, or paste the Character object's text to or from the Clipboard. Use the CharProps or ParaProps property to change the Character object's formatting.