ElementHost.Child 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 the UIElement hosted by the ElementHost control.

Namespace:   System.Windows.Forms.Integration
Assembly:  WindowsFormsIntegration (in WindowsFormsIntegration.dll)

public UIElement Child { get; set; }

Property Value

Type: System.Windows.UIElement

The hosted Windows Presentation Foundation (WPF) element.

Only one element can be hosted, but Child can have any number of child elements.

The following code example demonstrates how to use the Child property to assign a hosted WPF element. For more information, see Walkthrough: Hosting a 3-D WPF Composite Control in Windows Forms.

private void Form1_Load(object sender, EventArgs e)
    // Create the ElementHost control for hosting the
    // WPF UserControl.
    ElementHost host = new ElementHost();
    host.Dock = DockStyle.Fill;

    // Create the WPF UserControl.
    HostingWpfUserControlInWf.UserControl1 uc =
        new HostingWpfUserControlInWf.UserControl1();

    // Assign the WPF UserControl to the ElementHost control's
    // Child property.
    host.Child = uc;

    // Add the ElementHost control to the form's
    // collection of child controls.

.NET Framework
Available since 3.0
Return to top