Viewbox::Child Property


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

Gets or sets the single child of a Viewbox element.

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

property UIElement^ Child {
	virtual UIElement^ get() override;
	virtual void set(UIElement^ value) override;

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 = gcnew 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 = gcnew Grid();

// Create an Ellipse that will be hosted inside the Viewbox
myEllipse = gcnew Ellipse();
myEllipse->Stroke = Brushes::RoyalBlue;
myEllipse->Fill = Brushes::LightBlue;

// Create an TextBlock that will be hosted inside the Viewbox
myTextBlock = gcnew 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);

.NET Framework
Available since 3.0
Available since 4.0
Windows Phone Silverlight
Available since 7.1
Return to top