TextStyle Property [Visio 2003 SDK Documentation]

Gets or sets the text style for an object.

strRet = object**.TextStyle**

object**.TextStyle** = stringExpression

strRet     String. The current text style.

object     Required. An expression that returns a Shape or Selection object.

stringExpression     Required String. The name of the text style to apply.

Version added

2.0

Remarks

Setting this property is equivalent to selecting a style from the Text Style list in Microsoft Office Visio.

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 TextStyle 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 TextStyle property to a style that has line, text, and fill attributes changes only the text attributes).

To preserve a shape's local formatting, use the TextStyleKeepFmt property.

Beginning with Visio 2002, setting stringExpression 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 stringExpression 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 (Format menu).

Applies to | Selection object | Shape object

See Also | TextStyleKeepFmt property