WindowsFormsHost.Child WindowsFormsHost.Child WindowsFormsHost.Child WindowsFormsHost.Child Property

定義

取得或設定由 WindowsFormsHost 所裝載的子控制項。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

屬性值

主控的 Windows Forms 控制項。The hosted Windows Forms control.

例外狀況

已嘗試指派最上層表單做為裝載的控制項。An attempt was made to assign a top-level form as the hosted control.

範例

下列程式碼範例示範如何使用Child屬性將裝載的控制項加入WindowsFormsHost至專案。The following code example demonstrates how to use the Child property to add the hosted control to the WindowsFormsHost element. 如需詳細資訊,請參閱逐步解說:在 WPF中裝載 ActiveX 控制項。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.
    WmpAxLib.AxWindowsMediaPlayer 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

備註

只能主控一個子控制項,但Child可以有任意數目的子系。Only one child control can be hosted, but Child can have any number of children.

子控制項不可以是最上層的表單。The child control cannot be a top-level form.

如果Child ControlBox是,則表單的屬性會設定為falseFormIf Child is a Form, the form's ControlBox property is set to false.

XAML 文字使用方式XAML Text Usage

<物件>< object >

<hostedControl .../>< hostedControl .../>

</物件></ object >

XAML 值XAML Values

objectobject
WindowsFormsHost元素(或可能的子類別)。A WindowsFormsHost element (or a possible subclass).

hostedControlhostedControl
指定主控 Windows Forms 控制項的元素。An element that specifies the hosted Windows Forms control. 在標記中指定自訂控制項通常需要 xmlns 對應,請參閱Xaml 命名空間和 WPF xaml 的命名空間對應Specifying the custom control in markup usually requires an xmlns mapping, see XAML Namespaces and Namespace Mapping for WPF XAML.

適用於

另請參閱