Shape.Stroke Property

Gets or sets the Brush that specifies how the Shape outline is painted.

Namespace:  System.Windows.Shapes
Assembly:  PresentationFramework (in PresentationFramework.dll)

member Stroke : Brush with get, set

Property Value

Type: System.Windows.Media.Brush
A Brush that specifies how the Shape outline is painted. The default is a null reference (Nothing in Visual Basic).

This example shows how to draw a rectangle by using the Rectangle element.

To draw a rectangle, create a Rectangle element and specify its Width and Height. To paint the inside of the rectangle, set its Fill. To give the rectangle an outline, use its Stroke and StrokeThickness properties.

To give the rectangle rounded corners, specify the optional RadiusX and RadiusY properties. The RadiusX and RadiusY properties set the x-axis and y-axis radii of the ellipse that is used to round the corners of the rectangle.

In the following example, two Rectangle elements are drawn in a Canvas. The first rectangle has a Blue interior. The second rectangle has a Blue interior, a Black outline, and rounded corners.

  <Canvas Width="120" Height="200" >

  <!-- Draws a 100 by 50 rectangle with a solid blue fill. -->
    Canvas.Top="25" />

  <!-- Draws a 100 by 50 rectangle with a solid blue fill,
       a black outline, and rounded corners. -->
    Stroke="Black" StrokeThickness="4"
    RadiusX="20" RadiusY="20"


Although this example uses a Canvas to contain the rectangles, you can use rectangle elements (and all the other shape elements) with any Panel or Control that supports non-text content. In fact, rectangles are particularly useful for providing backgrounds for portions of Grid panels. For an example, see the Table Overview.

This example is part of a larger sample; for the complete sample, see Shape Elements Sample.

More Code

How to: Make a UIElement Transparent or Semi-TransparentThis example shows how to make a UIElement transparent or semi-transparent. To make an element transparent or semi-transparent, you set its Opacity property. A value of 0.0 makes the element completely transparent, while a value of 1.0 makes the element completely opaque. A value of 0.5 makes the element 50% opaque, and so on. An element's Opacity is set to 1.0 by default.
How to: Paint an Area with an ImageThis example shows how to use the ImageBrush class to paint an area with an image. An ImageBrush displays a single image, which is specified by its ImageSource property.
How to: Animate a Property Without Using a StoryboardThis example shows one way to apply an animation to a property without using a Storyboard.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
© 2014 Microsoft