Shape.TextStyleKeepFmt Property
| Visio Automation Reference |
Applies a text style to an object while preserving local formatting. Read/write.
Version Information
Version Added: Visio 2.0
Syntax
expression.TextStyleKeepFmt
expression A variable that represents a Shape object.
Return Value
String
Remarks
2.0
Setting the TextStyleKeepFmt property is equivalent to selecting the Preserve local formatting check box in the Style dialog box (Format menu).
Setting a style to a nonexistent style generates an error. Setting one kind of style to an existing style of another kind (for example, setting the TextStyleKeepFmt property to a fill style) does nothing. Setting one kind of style to an existing style that has more than one set of attributes changes only the attributes for that component (for example, setting the TextStyleKeepFmt property to a style that has line, text, and fill attributes changes only the text attributes).
Beginning with Visio 2002, setting TextStyleKeepFmt to an empty string ("") will cause the master's style to be reapplied to the selection or shape. (Earlier versions generate a "no such style" exception.) If the selection or shape has no master, its style remains unchanged. Setting TextStyleKeepFmt to an empty string is the equivalent of selecting Use master's format in the Text style, Line style, or Fill style list in the Style dialog box.
See Also