Export (0) Print
Expand All

Page.TextChanged Event (Visio)

Occurs after the text of a shape is changed in a document.

Version Added: Visio 4.1

Private Sub expression _TextChanged(ByVal Shape As [IVSHAPE])

expression A variable that represents a Page object.

Parameters

Name

Required/Optional

Data Type

Description

Shape

Required

[IVSHAPE]

The shape whose text changed.

The TextChanged event is fired when the raw text of a shape changes, such as when the characters Microsoft Visio stores for the shape change. If a shape's characters change because a user is typing, the TextChanged event does not fire until the text editing session terminates.

When a field is added to or removed from a shape's text, its raw text changes; hence, a TextChanged event fires. However, no TextChanged event fires when the text in a field changes. For example, a shape has a text field that shows its width. A TextChanged event does not fire when the shape's width changes, because the raw text stored for the shape has not changed, even though the apparent (expanded) text of the shape does change. Use the CellChanged event for one of the cells in the Text Fields section to detect when the text in a text field changes.

To access a shape's raw text, use the Text property. To access the text of a shape in which text fields have been expanded, use the Characters.Text property. You can determine the location and properties of text fields in a shape's text by using the Shape.Characters object.

In Visio 5.0 and earlier versions, the raw characters reported by the Text property for a field included four characters, the first being the escape character. Starting with Visio 2000, only a single escape character is present in the raw text stream.

If you are using Microsoft Visual Basic or Visual Basic for Applications (VBA), the syntax in this topic describes a common, efficient way to handle events.

If you want to create your own Event objects, use the Add or AddAdvise method. To create an Event object that runs an add-on, use the Add method as it applies to the EventList collection. To create an Event object that receives notification, use the AddAdvise method. To find an event code for the event you want to create, see Event codes.

Note Note

You can use VBA WithEvents variables to sink the TextChanged event.

For performance considerations, the Document object's event set does not include the TextChanged event. To sink the TextChanged event from a Document object (and from the ThisDocument object in a VBA project), you must use the AddAdvise method.

Show:
© 2014 Microsoft