FillStyle Property [Visio 2003 SDK Documentation]

  • Article

Returns or sets the fill style for an object.

strRet = object**.FillStyle**

object**.FillStyle** = stringExpression

strRet     String. The current fill style.

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

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

Version added

2.0

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 stringExpression 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 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).

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.

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

Applies to | Selection object | Shape object

See Also | FillStyleKeepFmt property