This documentation is archived and is not being maintained.

Viewbox.Child Property

Gets or sets the single child of a Viewbox element.

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

public override UIElement Child { get; set; }
    <UIElement .../>

Property Value

Type: System.Windows.UIElement
The single child of a Viewbox element. This property has no default value.

If you add an additional child element to a Viewbox it causes an ArgumentException at run time.

The following example shows how to create an instance of a Viewbox and then set its child property by using code.

// Create a Viewbox and add it to the Canvas
myViewbox = new Viewbox();
myViewbox.StretchDirection = StretchDirection.Both;
myViewbox.Stretch = Stretch.Fill;
myViewbox.MaxWidth = 400;
myViewbox.MaxHeight = 400;

// Create a Grid that will be hosted inside the Viewbox
myGrid = new Grid();

// Create an Ellipse that will be hosted inside the Viewbox
myEllipse = new Ellipse();
myEllipse.Stroke = Brushes.RoyalBlue;
myEllipse.Fill = Brushes.LightBlue;

// Create an TextBlock that will be hosted inside the Viewbox
myTextBlock = new TextBlock();
myTextBlock.Text = "Viewbox";

// Add the children to the Grid

// Add the Grid as the single child of the Viewbox
myViewbox.Child = myGrid;

// Position the Viewbox in the Parent Canvas
Canvas.SetTop(myViewbox, 100);
Canvas.SetLeft(myViewbox, 100);

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

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

.NET Framework

Supported in: 3.5, 3.0