WindowsFormsHost.Child Property

Definition

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

public:
 property System::Windows::Forms::Control ^ Child { System::Windows::Forms::Control ^ get(); void set(System::Windows::Forms::Control ^ value); };
public System.Windows.Forms.Control Child { get; set; }
member this.Child : System.Windows.Forms.Control with get, set
Public Property Child As Control

Property Value

The hosted Windows Forms control.

Exceptions

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

Examples

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 void Window_Loaded(object sender, RoutedEventArgs e) 
{
    // Create the interop host control.
    System.Windows.Forms.Integration.WindowsFormsHost host =
        new System.Windows.Forms.Integration.WindowsFormsHost();

    // Create the ActiveX control.
    var axWmp = new WmpAxLib.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.
    this.grid1.Children.Add(host);

    // Play a .wav file with the ActiveX control.
    axWmp.URL = @"C:\Windows\Media\tada.wav";
}
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

Remarks

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.

XAML Text Usage

< 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.

Applies to

See also