FillStyleKeepFmt Property [Visio 2003 SDK Documentation]

Applies a fill style to an object while preserving local formatting.

object**.FillStyleKeepFmt** = stringExpression

object     Required. An expression that returns a Selection or Shape object to which the fill style is applied.

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

Version added

2.0

Remarks

Setting the FillStyleKeepFmt 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. Setting one type of style to another type (for example, setting the FillStyleKeepFmt property to a line style) does nothing. Setting one type of style to another type that has more than one set of attributes changes only the appropriate attributes (for example, setting the FillStyleKeepFmt property to a style that has line, text, and fill attributes changes only the fill attributes).

Beginning with Microsoft Visio 2002, setting stringExpression to an empty string ("") causes 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 equivalent to selecting Use master's format in the Text style, Line style, or Fill style lists in the Style dialog box (on the Format menu, click Style).

Applies to | Selection object | Shape object

See Also | DefaultFillStyle property