FillStyle property
Returns or sets the fill style for an object.
Version added
2.0
Syntax
| |
| |
|
strRet |
String. The current fill style. |
|
object |
Required. An expression that returns a Selection or Shape object that has or gets the fill style. |
|
stringExpression |
Required String. The name of the fill style to apply. |
Remarks
Setting the FillStyle property is equivalent to selecting a style from the Fill Style list on the Format Shape toolbar.
Setting a style to a nonexistent style generates an error. Setting one type of style to another type (for example, setting the FillStyle 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 FillStyle property to a style with line, text, and fill attributes changes only the fill attributes.
To preserve a shape's local formatting, use the FillStyleKeepFmt property.
Beginning with Microsoft Visio 2002, a zero-length 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 a zero-length string ("") is equivalent to 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).