StyleKeepFmt property

Microsoft Visio Developer Reference

StyleKeepFmt property

See also   Example   

Applies a style to an object while preserving local formatting.

Version added

2.0

Syntax

object.StyleKeepFmt = stringExpression

object

Required. An expression that returns a Shape or Selection object that gets the style.

stringExpression

Required String. The name of the style to apply.

Remarks

Setting the StyleKeepFmt property is equivalent to selecting the Preserve local formatting check box in the Style dialog box (click Style on the Format menu). Setting a style to a nonexistent style generates an error.

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