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 フォームコントロール。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

注釈

ホストできる子コントロールは1つだけです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.

ChildForm場合、フォームのControlBoxプロパティはにfalse設定されます。If Child is a Form, the form's ControlBox property is set to false.

XAML テキストの使用XAML Text Usage

< object >< object >

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

</ object ></ object >

XAML 値XAML Values

objectobject
WindowsFormsHost要素 (または使用可能なサブクラス)。A WindowsFormsHost element (or a possible subclass).

hostedControlhostedControl
ホストされている Windows フォームコントロールを指定する要素。An element that specifies the hosted Windows Forms control. 通常、マークアップでカスタムコントロールを指定するには、xmlns マッピングが必要です。「 WPF xaml の Xaml 名前空間と名前空間のマッピング」を参照してください。Specifying the custom control in markup usually requires an xmlns mapping, see XAML Namespaces and Namespace Mapping for WPF XAML.

適用対象

こちらもご覧ください