Shape.FillStyle Property

Visio Automation Reference

Returns or sets the fill style for an object. Read/write.

Version Information
 Version Added:  Visio 2.0

Syntax

expression.FillStyle

expression   A variable that represents a Shape object.

Return Value
String

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 that has 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, setting the FillStyle property to a zero-length 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 the FillStyle property 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).

Example

This Microsoft Visual Basic for Applications (VBA) macro shows how to draw an oval and set its FillStyle property. To run this macro, open a drawing based on the Basic Diagram template.

Visual Basic for Applications
  
Public Sub FillStyle_Example() 
Dim vsoShape As Visio.Shape 

Set vsoShape = ActivePage.DrawOval(1.5, 10.5, 7.5, 6.5) 
vsoShape.FillStyle = "Basic" 

End Sub

See Also