This documentation is archived and is not being maintained.

WindowsFormsHost.Child Property

Gets or sets the child control hosted by the WindowsFormsHost element.

Namespace:  System.Windows.Forms.Integration
Assembly:  WindowsFormsIntegration (in WindowsFormsIntegration.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

'Declaration
Public Property Child As Control
	Get
	Set
<object>  <hostedControl .../></object>

XAML Values

object

A WindowsFormsHost element (or a possible subclass).

hostedControl

An element that specifies the hosted Windows Forms control. Specifying the custom control in markup usually requires an xmlns mapping, see XAML Namespaces and Namespace Mapping for WPF XAML.

Property Value

Type: System.Windows.Forms.Control
The hosted Windows Forms control.

ExceptionCondition
ArgumentException

An attempt was made to assign a top-level form as the hosted control.

Only one child control can be hosted, but Child can have any number of children.

The child control cannot be a top-level form.

If Child is a Form, the form's ControlBox property is set to false.

The following code example demonstrates how to use the Child property to add the hosted control to the WindowsFormsHost element. For more information, see Walkthrough: Hosting an ActiveX Control in WPF.


Private Sub Window_Loaded(ByVal sender As Object, ByVal e As RoutedEventArgs)

    ' Create the interop host control.
    Dim host As New System.Windows.Forms.Integration.WindowsFormsHost()

    ' Create the ActiveX control.
    Dim axWmp As New AxWMPLib.AxWindowsMediaPlayer()

    ' Assign the ActiveX control as the host control's child.
    host.Child = axWmp

    ' Add the interop host control to the Grid
    ' control's collection of child controls.
    Me.grid1.Children.Add(host)

    ' Play a .wav file with the ActiveX control.
    axWmp.URL = "C:\Windows\Media\tada.wav"

End Sub


.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: