TileBrush.Stretch Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets or sets a value that specifies how the content of this TileBrush stretches to fit its tiles.

Namespace:   System.Windows.Media
Assembly:  PresentationCore (in PresentationCore.dll)

Public Property Stretch As Stretch

Property Value

Type: System.Windows.Media.Stretch

A value that specifies how this TileBrush content is projected onto its base tile. The default value is Fill.

The Stretch property accepts the following values, which the Stretch enumeration defines:

  • None: The TileBrush content does not stretch to fill the tile.

  • Uniform: The TileBrush content is scaled to fit the tile dimensions. However, the aspect ratio of the content is preserved.

  • UniformToFill: The TileBrush content is scaled so that it completely fills the output area but preserves its original aspect ratio.

  • Fill: The TileBrush content is scaled to fit the tile. Because the content's height and width are scaled independently, the original aspect ratio of the content might not be preserved. That is, the TileBrush content might be distorted in order to completely fill the output tile.

The following image illustrates the different Stretch settings.

Different TileBrush Stretch settings

Different stretch settings

Note that you specify the dimensions of TileBrush content by using the Viewbox property; you specify the position and size of the TileBrush base tile by using the Viewport property.

TileBrush contents are never clipped to the Viewbox. However, TileBrush contents are clipped to the edges of the Viewport, which sets the dimensions for the TileBrush base tile.

The following illustration shows the effect of different Stretch settings on a TileBrush that has a Viewbox that is smaller than its Viewport. The parts of the image that are outside the Viewbox are tinted gray.

TileBrush with different Stretch settings

TileBrush with different Stretch settings

Identifier field


Metadata properties set to true


.NET Framework
Available since 3.0
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top