WindowsFormsHost.Child Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Forms.Integration
Assembly:
WindowsFormsIntegration.dll

Dient zum Abrufen oder Festlegen des untergeordneten Steuerelements, das vom WindowsFormsHost-Element gehostet wird.

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

Eigenschaftswert

Control

Das gehostete Windows Forms-Steuerelement.

Ausnahmen

ArgumentException

Es wurde versucht, ein Formular der obersten Ebene als gehostetes Steuerelement zuzuweisen.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der Child-Eigenschaft zum Hinzufügen des gehosteten Steuerelements zum WindowsFormsHost-Element veranschaulicht. Weitere Informationen finden Sie unter 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

Hinweise

Es kann nur ein untergeordnetes Steuerelement gehostet werden, aber Child kann eine beliebige Anzahl von untergeordneten Elementen haben.

Das untergeordnete Steuerelement kann kein Formular der obersten Ebene sein.

Wenn Child ein Formist, wird die ControlBox-Eigenschaft des Formulars auf falsefestgelegt.

XAML-Textverwendung

< Objekt>

< hostedControl-.../>

</ Objekt>

XAML-Werte

Objekt A WindowsFormsHost-Element (oder eine mögliche Unterklasse).

hostedControl Ein Element, das das gehostete Windows Forms-Steuerelement angibt. Die Angabe des benutzerdefinierten Steuerelements im Markup erfordert in der Regel eine XMLns-Zuordnung, siehe XAML-Namespaces und Namespacezuordnung für WPF-XAML-.

Gilt für:

Weitere Informationen