TextStyle property

Microsoft Visio Developer Reference

TextStyle property

   Example   

Gets or sets the text style for an object.

Version added

2.0

Syntax

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.

Remarks

Setting this property is equivalent to selecting a style from the Text Style list in 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 with line, text, and fill attributes changes only the text attributes).

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

Beginning with Microsoft Visio 2002, 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 (on the Format menu, click Style).