TileBrush.ViewboxUnits Property

Gets or sets a value that specifies whether the Viewbox value is relative to the bounding box of the TileBrush contents or whether the value is absolute. This is a dependency property.

Namespace: System.Windows.Media
Assembly: PresentationCore (in presentationcore.dll)
XML Namespace:  http://schemas.microsoft.com/winfx/2006/xaml/presentation

public BrushMappingMode ViewboxUnits { get; set; }
/** @property */
public BrushMappingMode get_ViewboxUnits ()

/** @property */
public void set_ViewboxUnits (BrushMappingMode value)

public function get ViewboxUnits () : BrushMappingMode

public function set ViewboxUnits (value : BrushMappingMode)

<object ViewboxUnits="BrushMappingMode" .../>

Property Value

A value that indicates whether the Viewbox value is relative to the bounding box of the TileBrush contents or whether it is an absolute value. The default value is RelativeToBoundingBox.

Identifier field


Metadata properties set to true


A value of RelativeToBoundingBox indicates that the ViewboxUnits are relative to the bounding box of the content. Note that a value of Absolute specifies device independent pixels instead of device pixels, which are device dependent. Therefore, when a value of Absolute applies, each pixel represents 1/96th of an inch.

You must remember this pixel distinction when you specify the Viewbox of an ImageBrush that has a BitmapImage as its source. For example, when you use the standard pixel as a measure, a 300 by 300 pixel image is only one inch in width if the image resolution is 300 dots per inch. However, when you want to set an absolute value, you must set the Viewbox to (0, 0, 96, 96) in order to include the whole image.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0