チュートリアル: WPF での Windows フォーム複合コントロールのホストWalkthrough: Hosting a Windows Forms Composite Control in WPF

Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) は、アプリケーションの作成に適した環境を提供します。provides a rich environment for creating applications. ただしがある場合、かなりの投資Windows フォームWindows Formsコードをより効果的か以上で再利用するには、そのコードの一部、WPFWPFアプリケーションではなく最初から修正します。However, when you have a substantial investment in Windows フォームWindows Forms code, it can be more effective to reuse at least some of that code in your WPFWPF application rather than to rewrite it from scratch. 最も一般的なシナリオでは、既存の Windows フォーム コントロールがある場合です。The most common scenario is when you have existing Windows Forms controls. 場合によってもがありませんこれらのコントロールのソース コードにアクセスします。In some cases, you might not even have access to the source code for these controls. WPFWPF このようなコントロールをホストするため、簡単な手順を提供するWPFWPFアプリケーション。provides a straightforward procedure for hosting such controls in a WPFWPF application. たとえば、使用することができますWPFWPF、特殊なをホストしているときに、プログラミングの大部分のDataGridViewコントロール。For example, you can use WPFWPF for most of your programming while hosting your specialized DataGridView controls.

このチュートリアルでのデータ入力を実行する Windows フォーム複合コントロールをホストするアプリケーションを通じて、WPFWPFアプリケーション。This walkthrough steps you through an application that hosts a Windows Forms composite control to perform data entry in a WPFWPF application. 複合コントロールは DLL にパッケージ化されています。The composite control is packaged in a DLL. この一般的な手順は、より複雑なアプリケーションやコントロールに拡張することができます。This general procedure can be extended to more complex applications and controls. このチュートリアルの外観と機能をほぼ同じにする目的はチュートリアル。Windows フォームでの WPF 複合コントロールをホストしているします。This walkthrough is designed to be nearly identical in appearance and functionality to Walkthrough: Hosting a WPF Composite Control in Windows Forms. 主な違いは、ホストする側とされる側が逆であることです。The primary difference is that the hosting scenario is reversed.

このチュートリアルは、2 つのセクションに分かれています。The walkthrough is divided into two sections. 最初のセクションでは、Windows フォーム複合コントロールの実装について簡単に説明します。The first section briefly describes the implementation of the Windows Forms composite control. 2 番目のセクションで詳細に複合コントロールをホストする方法について説明します、WPFWPFアプリケーションでは、コントロールからイベントを受信し、コントロールのプロパティの一部にアクセスします。The second section discusses in detail how to host the composite control in a WPFWPF application, receive events from the control, and access some of the control's properties.

このチュートリアルでは、以下のタスクを行います。Tasks illustrated in this walkthrough include:

  • Windows フォーム複合コントロールを実装します。Implementing the Windows Forms composite control.

  • WPF ホスト アプリケーションの実装。Implementing the WPF host application.

このチュートリアルで示すタスクの完全なコード一覧については、次を参照してください。 WPF サンプル Windows フォーム複合コントロールをホストしているします。For a complete code listing of the tasks illustrated in this walkthrough, see Hosting a Windows Forms Composite Control in WPF Sample.

必須コンポーネントPrerequisites

このチュートリアルを完了するには Visual Studio が必要です。You need Visual Studio to complete this walkthrough.

Windows フォーム複合コントロールを実装します。Implementing the Windows Forms Composite Control

この例で使用される Windows フォーム複合コントロールは、単純なデータ入力フォームです。The Windows Forms composite control used in this example is a simple data-entry form. このフォームは、ユーザーの名前とアドレスを受け取るし、カスタム イベントを使用してホストにその情報を返します。This form takes the user's name and address and then uses a custom event to return that information to the host. 次の図はレンダリングされたコントロールを示しています。The following illustration shows the rendered control.

次の図は、Windows フォーム複合コントロールを示しています。The following image shows a Windows Forms composite control:

シンプルな Windows フォーム コントロールを示すスクリーン ショット。

プロジェクトの作成Creating the Project

プロジェクトを開始するにはTo start the project:

  1. 起動Microsoft Visual StudioMicrosoft Visual Studioを開き、新しいプロジェクト ダイアログ ボックス。Launch Microsoft Visual StudioMicrosoft Visual Studio, and open the New Project dialog box.

  2. ウィンドウのカテゴリの選択、 Windows フォーム コントロール ライブラリテンプレート。In the Window category, select the Windows Forms Control Library template.

  3. 新しいプロジェクトに MyControls という名前を付けます。Name the new project MyControls.

  4. など指定便利な名前付きの最上位フォルダーの場所WpfHostingWindowsFormsControlします。For the location, specify a conveniently named top-level folder, such as WpfHostingWindowsFormsControl. このフォルダーには後でホスト アプリケーションも配置します。Later, you will put the host application in this folder.

  5. [OK] をクリックして、プロジェクトを作成します。Click OK to create the project. 既定のプロジェクトには、という名前の 1 つのコントロールが含まれています。UserControl1します。The default project contains a single control named UserControl1.

  6. ソリューション エクスプローラで、名前を変更UserControl1MyControl1します。In Solution Explorer, rename UserControl1 to MyControl1.

プロジェクトは、以下のシステム DLL を参照している必要があります。Your project should have references to the following system DLLs. 既定で含まれていないこれらの Dll のいずれかの場合は、プロジェクトに追加します。If any of these DLLs are not included by default, add them to the project.

  • システムSystem

  • System.DataSystem.Data

  • System.DrawingSystem.Drawing

  • System.Windows.FormsSystem.Windows.Forms

  • System.XmlSystem.Xml

フォームへのコントロールの追加Adding Controls to the Form

コントロールをフォームに追加します。To add controls to the form:

  • 開いているMyControl1デザイナー。Open MyControl1 in the designer.

5 つ追加Labelコントロールとそれに対応するTextBoxコントロール、サイズ、およびフォーム上の図のように配置されます。Add five Label controls and their corresponding TextBox controls, sized and arranged as they are in the preceding illustration, on the form. 例では、TextBoxコントロールの名前が付けられます。In the example, the TextBox controls are named:

  • txtName

  • txtAddress

  • txtCity

  • txtState

  • txtZip

2 つ追加Buttonというラベルの付いたコントロールOKキャンセルします。Add two Button controls labeled OK and Cancel. この例では、ボタン名はbtnOKbtnCancel、それぞれします。In the example, the button names are btnOK and btnCancel, respectively.

サポート コードを実装します。Implementing the Supporting Code

コード ビューで、フォームを開きます。Open the form in code view. コントロールがそのホストにカスタムを発生させることによって、収集したデータを返しますOnButtonClickイベント。The control returns the collected data to its host by raising the custom OnButtonClick event. データは、イベント引数オブジェクトに含まれます。The data is contained in the event argument object. 次のコードでは、イベントとデリゲートの宣言を示します。The following code shows the event and delegate declaration.

MyControl1 クラスに次のコードを追加します。Add the following code to the MyControl1 class.

public delegate void MyControlEventHandler(object sender, MyControlEventArgs args);
public event MyControlEventHandler OnButtonClick;
Public Delegate Sub MyControlEventHandler(ByVal sender As Object, ByVal args As MyControlEventArgs)
Public Event OnButtonClick As MyControlEventHandler

MyControlEventArgsクラスには、ホストに返される情報が含まれています。The MyControlEventArgs class contains the information to be returned to the host.

フォームに次のクラスを追加します。Add the following class to the form.

public class MyControlEventArgs : EventArgs
{
    private string _Name;
    private string _StreetAddress;
    private string _City;
    private string _State;
    private string _Zip;
    private bool _IsOK;

    public MyControlEventArgs(bool result,
                                   string name,
                                   string address,
                                   string city,
                                   string state,
                                   string zip)
    {
        _IsOK = result;
        _Name = name;
        _StreetAddress = address;
        _City = city;
        _State = state;
        _Zip = zip;
    }

    public string MyName
    {
        get { return _Name; }
        set { _Name = value; }
    }
    public string MyStreetAddress
    {
        get { return _StreetAddress; }
        set { _StreetAddress = value; }
    }
    public string MyCity
    {
        get { return _City; }
        set { _City = value; }
    }
    public string MyState
    {
        get { return _State; }
        set { _State = value; }
    }
    public string MyZip
    {
        get { return _Zip; }
        set { _Zip = value; }
    }
    public bool IsOK
    {
        get { return _IsOK; }
        set { _IsOK = value; }
    }
}
Public Class MyControlEventArgs
    Inherits EventArgs
    Private _Name As String
    Private _StreetAddress As String
    Private _City As String
    Private _State As String
    Private _Zip As String
    Private _IsOK As Boolean
    
    
    Public Sub New(ByVal result As Boolean, ByVal name As String, ByVal address As String, ByVal city As String, ByVal state As String, ByVal zip As String) 
        _IsOK = result
        _Name = name
        _StreetAddress = address
        _City = city
        _State = state
        _Zip = zip
    
    End Sub
    
    
    Public Property MyName() As String 
        Get
            Return _Name
        End Get
        Set
            _Name = value
        End Set
    End Property
    
    Public Property MyStreetAddress() As String 
        Get
            Return _StreetAddress
        End Get
        Set
            _StreetAddress = value
        End Set
    End Property
    
    Public Property MyCity() As String 
        Get
            Return _City
        End Get
        Set
            _City = value
        End Set
    End Property
    
    Public Property MyState() As String 
        Get
            Return _State
        End Get
        Set
            _State = value
        End Set
    End Property
    
    Public Property MyZip() As String 
        Get
            Return _Zip
        End Get
        Set
            _Zip = value
        End Set
    End Property
    
    Public Property IsOK() As Boolean 
        Get
            Return _IsOK
        End Get
        Set
            _IsOK = value
        End Set
    End Property
End Class

ユーザーがクリックすると、 okまたはキャンセル ボタン、Clickイベント ハンドラーを作成、MyControlEventArgsデータを格納しているオブジェクトさせ、OnButtonClickイベント。When the user clicks the OK or Cancel button, the Click event handlers create a MyControlEventArgs object that contains the data and raises the OnButtonClick event. 2 つのハンドラーの唯一の違いは、イベント引数のIsOKプロパティ。The only difference between the two handlers is the event argument's IsOK property. このプロパティは、どのボタンがクリックされたかを判断するホストを使用できます。This property enables the host to determine which button was clicked. 設定されているtrue[ok] ボタン、およびfalseキャンセルボタンをクリックします。It is set to true for the OK button, and false for the Cancel button. 次のコードは、2 つのボタン ハンドラーを示しています。The following code shows the two button handlers.

MyControl1 クラスに次のコードを追加します。Add the following code to the MyControl1 class.

private void btnOK_Click(object sender, System.EventArgs e)
{

    MyControlEventArgs retvals = new MyControlEventArgs(true,
                                                         txtName.Text,
                                                         txtAddress.Text,
                                                         txtCity.Text,
                                                         txtState.Text,
                                                         txtZip.Text);
    OnButtonClick(this, retvals);
}

private void btnCancel_Click(object sender, System.EventArgs e)
{
    MyControlEventArgs retvals = new MyControlEventArgs(false,
                                                         txtName.Text,
                                                         txtAddress.Text,
                                                         txtCity.Text,
                                                         txtState.Text,
                                                         txtZip.Text);
    OnButtonClick(this, retvals);
}
Private Sub btnOK_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles btnOK.Click

    Dim retvals As New MyControlEventArgs(True, txtName.Text, txtAddress.Text, txtCity.Text, txtState.Text, txtZip.Text)
    RaiseEvent OnButtonClick(Me, retvals)

End Sub

Private Sub btnCancel_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles btnCancel.Click
    Dim retvals As New MyControlEventArgs(False, txtName.Text, txtAddress.Text, txtCity.Text, txtState.Text, txtZip.Text)
    RaiseEvent OnButtonClick(Me, retvals)

End Sub

アセンブリに厳密な名前を付けると、アセンブリのビルドGiving the Assembly a Strong Name and Building the Assembly

このアセンブリによって参照されるのWPFWPFアプリケーションでは、厳密な名前必要があります。For this assembly to be referenced by a WPFWPF application, it must have a strong name. 厳密な名前を作成するには、Sn.exe でキー ファイルを作成し、プロジェクトに追加します。To create a strong name, create a key file with Sn.exe and add it to your project.

  1. Visual StudioVisual Studio のコマンド プロンプトを開きます。Open a Visual StudioVisual Studio command prompt. これを行うには、クリックして、開始] メニューの [クリックしてすべてのプログラムまたは Microsoft Visual Studio 2010 または Visual Studio ツール/visual Studio コマンド プロンプトTo do so, click the Start menu, and then select All Programs/Microsoft Visual Studio 2010/Visual Studio Tools/Visual Studio Command Prompt. これは、カスタマイズされた環境変数のコンソール ウィンドウを起動します。This launches a console window with customized environment variables.

  2. コマンド プロンプトを使用して、cdコマンドをプロジェクト フォルダーに移動します。At the command prompt, use the cd command to go to your project folder.

  3. 次のコマンドを実行して MyControls.snk をという名前のキー ファイルを生成します。Generate a key file named MyControls.snk by running the following command.

    Sn.exe -k MyControls.snk
    
  4. キー ファイルをプロジェクトに含めるにソリューション エクスプ ローラーでプロジェクト名を右クリックし をクリックし、プロパティします。To include the key file in your project, right-click the project name in Solution Explorer and then click Properties. プロジェクト デザイナーで、クリックして、署名] タブで、[、アセンブリに署名チェック ボックスをオンし、キー ファイルを参照します。In the Project Designer, click the Signing tab, select the Sign the assembly check box and then browse to your key file.

  5. ソリューションをビルドします。Build the solution. ビルドでは、MyControls.dll という名前の DLL が生成されます。The build will produce a DLL named MyControls.dll.

WPF ホスト アプリケーションの実装Implementing the WPF Host Application

WPFWPFホスト アプリケーションで使用する、WindowsFormsHostコントロールをホストにMyControl1します。The WPFWPF host application uses the WindowsFormsHost control to host MyControl1. アプリケーションのハンドル、OnButtonClickコントロールからデータを受信するイベントです。The application handles the OnButtonClick event to receive the data from the control. コントロールのプロパティの一部を変更するためのオプション ボタンのコレクションがあります、WPFWPFアプリケーション。It also has a collection of option buttons that enable you to change some of the control's properties from the WPFWPF application. 次の図は、完成したアプリケーションを示します。The following illustration shows the finished application.

次の図は、WPF アプリケーションに埋め込まれたコントロールを含む、完全なアプリケーションを示しています。The following image shows the complete application, including the control embedded in the WPF application:

コントロールを示すスクリーン ショットは、WPF ページに埋め込まれます。

プロジェクトの作成Creating the Project

プロジェクトを開始するにはTo start the project:

  1. 開いているVisual StudioVisual Studio、選択および新しいプロジェクトします。Open Visual StudioVisual Studio, and select New Project.

  2. ウィンドウのカテゴリの選択、 WPF アプリケーションテンプレート。In the Window category, select the WPF Application template.

  3. 新しいプロジェクトに WpfHost という名前を付けます。Name the new project WpfHost.

  4. 配置場所として、MyControls の配置先と同じ最上位フォルダーを指定します。For the location, specify the same top-level folder that contains the MyControls project.

  5. [OK] をクリックして、プロジェクトを作成します。Click OK to create the project.

含んでいる DLL への参照を追加する必要がありますMyControl1およびその他のアセンブリ。You also need to add references to the DLL that contains MyControl1 and other assemblies.

  1. ソリューション エクスプ ローラーでプロジェクト名を右クリックして参照の追加します。Right-click the project name in Solution Explorer and select Add Reference.

  2. をクリックして、参照タブをクリックし、MyControls.dll を含むフォルダーを参照します。Click the Browse tab, and browse to the folder that contains MyControls.dll. このチュートリアルの場合は、MyControls\bin\Debug フォルダーです。For this walkthrough, this folder is MyControls\bin\Debug.

  3. MyControls.dll を選択し、クリックしてOKします。Select MyControls.dll, and then click OK.

  4. これは、WindowsFormsIntegration.dll がという名前 WindowsFormsIntegration アセンブリへの参照を追加します。Add a reference to the WindowsFormsIntegration assembly, which is named WindowsFormsIntegration.dll.

基本的なレイアウトを実装します。Implementing the Basic Layout

ユーザー インターフェイス (UI)user interface (UI) MainWindow.xaml で、ホストのアプリケーションを実装します。The ユーザー インターフェイス (UI)user interface (UI) of the host application is implemented in MainWindow.xaml. このファイルを含むExtensible Application Markup Language (XAML)Extensible Application Markup Language (XAML)レイアウトを定義し、Windows フォーム コントロールをホストするマークアップ。This file contains Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) markup that defines the layout, and hosts the Windows Forms control. アプリケーションは、3 つのリージョンに分かれています。The application is divided into three regions:

  • コントロール プロパティパネルで、ホストされるコントロールのさまざまなプロパティを変更に使用できるオプション ボタンのコレクションが含まれています。The Control Properties panel, which contains a collection of option buttons that you can use to modify various properties of the hosted control.

  • コントロールからのデータパネルで、いくつか含むTextBlockホストされるコントロールからデータを表示する要素が返されます。The Data from Control panel, which contains several TextBlock elements that display the data returned from the hosted control.

  • ホストされるコントロール自体。The hosted control itself.

次の XAML は、基本的なレイアウトに表示されます。The basic layout is shown in the following XAML. ために必要なマークアップをホストにMyControl1をこの例から省略するは、後ほど説明します。The markup that is needed to host MyControl1 is omitted from this example, but will be discussed later.

MainWindow.xaml で XAML を次のように置き換えます。Replace the XAML in MainWindow.xaml with the following. Visual Basic を使用している場合にクラスを変更x:Class="MainWindow"します。If you are using Visual Basic, change the class to x:Class="MainWindow".

<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
      xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
      x:Class="WpfHost.MainWindow"
      xmlns:mcl="clr-namespace:MyControls;assembly=MyControls"
      Loaded="Init">
  <DockPanel>
    <DockPanel.Resources>
      <Style x:Key="inlineText" TargetType="{x:Type Inline}">
        <Setter Property="FontWeight" Value="Normal"/>
      </Style>
      <Style x:Key="titleText" TargetType="{x:Type TextBlock}">
        <Setter Property="DockPanel.Dock" Value="Top"/>
        <Setter Property="FontWeight" Value="Bold"/>
        <Setter Property="Margin" Value="10,5,10,0"/>
      </Style>
    </DockPanel.Resources>

    <StackPanel Orientation="Vertical"
                DockPanel.Dock="Left"
                Background="Bisque"
                Width="250">

      <TextBlock  Margin="10,10,10,10"
                  FontWeight="Bold"
                  FontSize="12">Control Properties</TextBlock>
      <TextBlock Style="{StaticResource titleText}">Background Color</TextBlock>
      <StackPanel Margin="10,10,10,10">
        <RadioButton Name="rdbtnOriginalBackColor"
                    IsChecked="True"
                    Click="BackColorChanged">Original</RadioButton>
        <RadioButton Name="rdbtnBackGreen"
                    Click="BackColorChanged">LightGreen</RadioButton>
        <RadioButton Name="rdbtnBackSalmon"
                    Click="BackColorChanged">LightSalmon</RadioButton>
      </StackPanel>

      <TextBlock Style="{StaticResource titleText}">Foreground Color</TextBlock>
      <StackPanel Margin="10,10,10,10">
        <RadioButton Name="rdbtnOriginalForeColor"
                    IsChecked="True"
                    Click="ForeColorChanged">Original</RadioButton>
        <RadioButton Name="rdbtnForeRed"
                    Click="ForeColorChanged">Red</RadioButton>
        <RadioButton Name="rdbtnForeYellow"
                    Click="ForeColorChanged">Yellow</RadioButton>
      </StackPanel>

      <TextBlock Style="{StaticResource titleText}">Font Family</TextBlock>
      <StackPanel Margin="10,10,10,10">
        <RadioButton Name="rdbtnOriginalFamily"
                     IsChecked="True"
                    Click="FontChanged">Original</RadioButton>
        <RadioButton Name="rdbtnTimes"
                    Click="FontChanged">Times New Roman</RadioButton>
        <RadioButton Name="rdbtnWingdings"
                    Click="FontChanged">Wingdings</RadioButton>
      </StackPanel>

      <TextBlock Style="{StaticResource titleText}">Font Size</TextBlock>
      <StackPanel Margin="10,10,10,10">
        <RadioButton Name="rdbtnOriginalSize"
                    IsChecked="True"
                    Click="FontSizeChanged">Original</RadioButton>
        <RadioButton Name="rdbtnTen"
                    Click="FontSizeChanged">10</RadioButton>
        <RadioButton Name="rdbtnTwelve"
                    Click="FontSizeChanged">12</RadioButton>
      </StackPanel>

      <TextBlock Style="{StaticResource titleText}">Font Style</TextBlock>
      <StackPanel Margin="10,10,10,10">
        <RadioButton Name="rdbtnNormalStyle"
                     IsChecked="True"
                     Click="StyleChanged">Original</RadioButton>
        <RadioButton Name="rdbtnItalic"
                     Click="StyleChanged">Italic</RadioButton>
      </StackPanel>

      <TextBlock Style="{StaticResource titleText}">Font Weight</TextBlock>
      <StackPanel Margin="10,10,10,10">
        <RadioButton Name="rdbtnOriginalWeight"
                     IsChecked="True"
                   Click="WeightChanged">
          Original
        </RadioButton>
        <RadioButton Name="rdbtnBold"
                   Click="WeightChanged">Bold</RadioButton>
      </StackPanel>
    </StackPanel>

    <WindowsFormsHost Name="wfh"
                     DockPanel.Dock="Top"
                     Height="300">
      <mcl:MyControl1 Name="mc"/>
    </WindowsFormsHost>
    
    <StackPanel Orientation="Vertical"
                Height="Auto"
                Background="LightBlue">
      <TextBlock Margin="10,10,10,10"
            FontWeight="Bold"
            FontSize="12">Data From Control</TextBlock>
      <TextBlock Style="{StaticResource titleText}">
        Name: <Span Name="txtName" Style="{StaticResource inlineText}"/>
      </TextBlock>
      <TextBlock Style="{StaticResource titleText}">
        Street Address: <Span Name="txtAddress" Style="{StaticResource inlineText}"/>
      </TextBlock>
      <TextBlock Style="{StaticResource titleText}">
        City: <Span Name="txtCity" Style="{StaticResource inlineText}"/>
      </TextBlock>
      <TextBlock Style="{StaticResource titleText}">
        State: <Span Name="txtState" Style="{StaticResource inlineText}"/>
      </TextBlock>
      <TextBlock Style="{StaticResource titleText}">
        Zip: <Span Name="txtZip" Style="{StaticResource inlineText}"/>
      </TextBlock>
    </StackPanel>
  </DockPanel>
</Window>

最初のStackPanel要素には、複数のセットが含まれています。RadioButtonホストされるコントロールのさまざまな既定のプロパティを変更できるようにするコントロール。The first StackPanel element contains several sets of RadioButton controls that enable you to modify various default properties of the hosted control. これは、後は、WindowsFormsHost要素、どのホストMyControl1します。That is followed by a WindowsFormsHost element, which hosts MyControl1. 最終的なStackPanel要素がいくつか含まれていますTextBlockホストされるコントロールによって返されるデータを表示する要素。The final StackPanel element contains several TextBlock elements that display the data that is returned by the hosted control. 要素の順序とDockHeight属性の設定では、ウィンドウにホストされるコントロールを埋め込むギャップやゆがみがないです。The ordering of the elements and the Dock and Height attribute settings embed the hosted control into the window with no gaps or distortion.

コントロールをホストしています。Hosting the Control

次の編集したバージョン以前の XAML のために必要な要素について重点的にホストMyControl1します。The following edited version of the previous XAML focuses on the elements that are needed to host MyControl1.

<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
      xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
      x:Class="WpfHost.MainWindow"
      xmlns:mcl="clr-namespace:MyControls;assembly=MyControls"
      Loaded="Init">
<WindowsFormsHost Name="wfh"
                 DockPanel.Dock="Top"
                 Height="300">
  <mcl:MyControl1 Name="mc"/>
</WindowsFormsHost>

xmlnsマッピング属性の名前空間への参照を作成し、MyControlsホストされるコントロールを含む名前空間。The xmlns namespace mapping attribute creates a reference to the MyControls namespace that contains the hosted control. このマッピングを使用すると、表すMyControl1XAMLXAMLとして<mcl:MyControl1>します。This mapping enables you to represent MyControl1 in XAMLXAML as <mcl:MyControl1>.

2 つの要素、XAML では、ホスティングを処理します。Two elements in the XAML handle the hosting:

  • WindowsFormsHost 表す、WindowsFormsHost要素での Windows フォーム コントロールをホストすることができます、WPFWPFアプリケーション。WindowsFormsHost represents the WindowsFormsHost element that enables you to host a Windows Forms control in a WPFWPF application.

  • mcl:MyControl1を表すMyControl1、に追加されます、WindowsFormsHost要素の子のコレクション。mcl:MyControl1, which represents MyControl1, is added to the WindowsFormsHost element's child collection. 一部としてこの Windows フォーム コントロールを表示する結果として、WPFWPFウィンドウ、およびするが、アプリケーションからコントロールと通信できます。As a result, this Windows Forms control is rendered as part of the WPFWPF window, and you can communicate with the control from the application.

分離コード ファイルの実装Implementing the Code-Behind File

MainWindow.xaml.vb または MainWindow.xaml.cs で、分離コード ファイルには機能を実装する手続き型コードが含まれています、UIUI前のセクションで説明します。The code-behind file, MainWindow.xaml.vb or MainWindow.xaml.cs, contains the procedural code that implements the functionality of the UIUI discussed in the preceding section. 主な作業は次のとおりです。The primary tasks are:

  • イベント ハンドラーをアタッチするMyControl1OnButtonClickイベント。Attaching an event handler to MyControl1's OnButtonClick event.

  • さまざまなプロパティを変更するMyControl1オプション ボタンのコレクションの設定方法に基づいて、します。Modifying various properties of MyControl1, based on how the collection of option buttons are set.

  • コントロールによって収集されたデータを表示します。Displaying the data collected by the control.

アプリケーションの初期化Initializing the Application

ウィンドウのイベント ハンドラーの初期化コードが含まれているLoadedイベントをコントロールのイベント ハンドラーをアタッチおよびOnButtonClickイベント。The initialization code is contained in an event handler for the window's Loaded event and attaches an event handler to the control's OnButtonClick event.

MainWindow.xaml.vb または MainWindow.xaml.cs で次のコードを追加、MainWindowクラス。In MainWindow.xaml.vb or MainWindow.xaml.cs, add the following code to the MainWindow class.

private Application app;
private Window myWindow;
FontWeight initFontWeight;
Double initFontSize;
FontStyle initFontStyle;
SolidColorBrush initBackBrush;
SolidColorBrush initForeBrush;
FontFamily initFontFamily;
bool UIIsReady = false;

private void Init(object sender, EventArgs e)
{
    app = System.Windows.Application.Current;
    myWindow = (Window)app.MainWindow;
    myWindow.SizeToContent = SizeToContent.WidthAndHeight;
    wfh.TabIndex = 10;
    initFontSize = wfh.FontSize;
    initFontWeight = wfh.FontWeight;
    initFontFamily = wfh.FontFamily;
    initFontStyle = wfh.FontStyle;
    initBackBrush = (SolidColorBrush)wfh.Background;
    initForeBrush = (SolidColorBrush)wfh.Foreground;
    (wfh.Child as MyControl1).OnButtonClick += new MyControl1.MyControlEventHandler(Pane1_OnButtonClick);
    UIIsReady = true;
}
Private app As Application
Private myWindow As Window
Private initFontWeight As FontWeight
Private initFontSize As [Double]
Private initFontStyle As FontStyle
Private initBackBrush As SolidColorBrush
Private initForeBrush As SolidColorBrush
Private initFontFamily As FontFamily
Private UIIsReady As Boolean = False


Private Sub Init(ByVal sender As Object, ByVal e As RoutedEventArgs)
    app = System.Windows.Application.Current
    myWindow = CType(app.MainWindow, Window)
    myWindow.SizeToContent = SizeToContent.WidthAndHeight
    wfh.TabIndex = 10
    initFontSize = wfh.FontSize
    initFontWeight = wfh.FontWeight
    initFontFamily = wfh.FontFamily
    initFontStyle = wfh.FontStyle
    initBackBrush = CType(wfh.Background, SolidColorBrush)
    initForeBrush = CType(wfh.Foreground, SolidColorBrush)

    Dim mc As MyControl1 = wfh.Child

    AddHandler mc.OnButtonClick, AddressOf Pane1_OnButtonClick
    UIIsReady = True

End Sub

XAMLXAML以前に追加した説明MyControl1WindowsFormsHostキャストする要素の子要素のコレクション、WindowsFormsHost要素のChildへの参照を取得するMyControl1します。Because the XAMLXAML discussed previously added MyControl1 to the WindowsFormsHost element's child element collection, you can cast the WindowsFormsHost element's Child to get the reference to MyControl1. イベント ハンドラーをアタッチするその参照を使用することができますしOnButtonClickします。You can then use that reference to attach an event handler to OnButtonClick.

コントロール自体への参照を提供するだけでなくWindowsFormsHost多数のアプリケーションから操作できるコントロールのプロパティを公開します。In addition to providing a reference to the control itself, WindowsFormsHost exposes a number of the control's properties, which you can manipulate from the application. 初期化コードでは、プライベートのグローバル変数を後で、アプリケーションで使用するこれらの値を割り当てます。The initialization code assigns those values to private global variables for later use in the application.

内の型を簡単にアクセスできるように、 MyControls DLL では、次の追加Importsまたはusingファイルの先頭にステートメント。So that you can easily access the types in the MyControls DLL, add the following Imports or using statement to the top of the file.

Imports MyControls
using MyControls;

OnButtonClick のイベントを処理します。Handling the OnButtonClick Event

MyControl1 発生させる、OnButtonClickイベントかのコントロールのボタンをクリックするとします。MyControl1 raises the OnButtonClick event when the user clicks either of the control's buttons.

MainWindow クラスに次のコードを追加します。Add the following code to the MainWindow class.

//Handle button clicks on the Windows Form control
private void Pane1_OnButtonClick(object sender, MyControlEventArgs args)
{
    txtName.Inlines.Clear();
    txtAddress.Inlines.Clear();
    txtCity.Inlines.Clear();
    txtState.Inlines.Clear();
    txtZip.Inlines.Clear();

    if (args.IsOK)
    {
        txtName.Inlines.Add( " " + args.MyName );
        txtAddress.Inlines.Add( " " + args.MyStreetAddress );
        txtCity.Inlines.Add( " " + args.MyCity );
        txtState.Inlines.Add( " " + args.MyState );
        txtZip.Inlines.Add( " " + args.MyZip );
    }
}
'Handle button clicks on the Windows Form control
Private Sub Pane1_OnButtonClick(ByVal sender As Object, ByVal args As MyControlEventArgs)
    txtName.Inlines.Clear()
    txtAddress.Inlines.Clear()
    txtCity.Inlines.Clear()
    txtState.Inlines.Clear()
    txtZip.Inlines.Clear()

    If args.IsOK Then
        txtName.Inlines.Add(" " + args.MyName)
        txtAddress.Inlines.Add(" " + args.MyStreetAddress)
        txtCity.Inlines.Add(" " + args.MyCity)
        txtState.Inlines.Add(" " + args.MyState)
        txtZip.Inlines.Add(" " + args.MyZip)
    End If

End Sub

テキスト ボックス内のデータをまとめ、MyControlEventArgsオブジェクト。The data in the text boxes is packed into the MyControlEventArgs object. ユーザーがクリックした場合、 OKボタン、イベント ハンドラーは、データを抽出し、下のパネルに表示しますMyControl1If the user clicks the OK button, the event handler extracts the data and displays it in the panel below MyControl1.

コントロールのプロパティの変更Modifying the Control’s Properties

WindowsFormsHost要素がいくつかのホストされるコントロールの既定のプロパティを公開します。The WindowsFormsHost element exposes several of the hosted control's default properties. その結果、アプリケーションのスタイルをより厳密に一致するようにコントロールの外観を変更できます。As a result, you can change the appearance of the control to match the style of your application more closely. 左側のパネルのオプション ボタンのセットは、いくつかの色とフォントのプロパティを変更するユーザーを有効にします。The sets of option buttons in the left panel enable the user to modify several color and font properties. ボタンの各セットのハンドラーがある、Clickイベントでは、ユーザーのオプション ボタンの選択を検出し、コントロールに対応するプロパティを変更します。Each set of buttons has a handler for the Click event, which detects the user's option button selections and changes the corresponding property on the control.

MainWindow クラスに次のコードを追加します。Add the following code to the MainWindow class.

private void BackColorChanged(object sender, RoutedEventArgs e)
{
    if (sender == rdbtnBackGreen)
        wfh.Background = new SolidColorBrush(Colors.LightGreen);
    else if (sender == rdbtnBackSalmon)
        wfh.Background = new SolidColorBrush(Colors.LightSalmon);
    else if (UIIsReady == true)
        wfh.Background = initBackBrush;
}

private void ForeColorChanged(object sender, RoutedEventArgs e)
{
    if (sender == rdbtnForeRed)
        wfh.Foreground = new SolidColorBrush(Colors.Red);
    else if (sender == rdbtnForeYellow)
        wfh.Foreground = new SolidColorBrush(Colors.Yellow);
    else if (UIIsReady == true)
        wfh.Foreground = initForeBrush;
}

private void FontChanged(object sender, RoutedEventArgs e)
{
    if (sender == rdbtnTimes)
        wfh.FontFamily = new FontFamily("Times New Roman");
    else if (sender == rdbtnWingdings)
        wfh.FontFamily = new FontFamily("Wingdings");
    else if (UIIsReady == true)
        wfh.FontFamily = initFontFamily;
}
private void FontSizeChanged(object sender, RoutedEventArgs e)
{
    if (sender == rdbtnTen)
        wfh.FontSize = 10;
    else if (sender == rdbtnTwelve)
        wfh.FontSize = 12;
    else if (UIIsReady == true)
        wfh.FontSize = initFontSize;
}
private void StyleChanged(object sender, RoutedEventArgs e)
{
    if (sender == rdbtnItalic)
        wfh.FontStyle = FontStyles.Italic;
    else if (UIIsReady == true)
        wfh.FontStyle = initFontStyle;
}
private void WeightChanged(object sender, RoutedEventArgs e)
{
    if (sender == rdbtnBold)
        wfh.FontWeight = FontWeights.Bold;
    else if (UIIsReady == true)
        wfh.FontWeight = initFontWeight;
}
Private Sub BackColorChanged(ByVal sender As Object, ByVal e As RoutedEventArgs)

    If sender.Equals(rdbtnBackGreen) Then
        wfh.Background = New SolidColorBrush(Colors.LightGreen)
    ElseIf sender.Equals(rdbtnBackSalmon) Then
        wfh.Background = New SolidColorBrush(Colors.LightSalmon)
    ElseIf UIIsReady = True Then
        wfh.Background = initBackBrush
    End If

End Sub

Private Sub ForeColorChanged(ByVal sender As Object, ByVal e As RoutedEventArgs)
    If sender.Equals(rdbtnForeRed) Then
        wfh.Foreground = New SolidColorBrush(Colors.Red)
    ElseIf sender.Equals(rdbtnForeYellow) Then
        wfh.Foreground = New SolidColorBrush(Colors.Yellow)
    ElseIf UIIsReady = True Then
        wfh.Foreground = initForeBrush
    End If

End Sub

Private Sub FontChanged(ByVal sender As Object, ByVal e As RoutedEventArgs)
    If sender.Equals(rdbtnTimes) Then
        wfh.FontFamily = New FontFamily("Times New Roman")
    ElseIf sender.Equals(rdbtnWingdings) Then
        wfh.FontFamily = New FontFamily("Wingdings")
    ElseIf UIIsReady = True Then
        wfh.FontFamily = initFontFamily
    End If

End Sub

Private Sub FontSizeChanged(ByVal sender As Object, ByVal e As RoutedEventArgs)
    If sender.Equals(rdbtnTen) Then
        wfh.FontSize = 10
    ElseIf sender.Equals(rdbtnTwelve) Then
        wfh.FontSize = 12
    ElseIf UIIsReady = True Then
        wfh.FontSize = initFontSize
    End If

End Sub

Private Sub StyleChanged(ByVal sender As Object, ByVal e As RoutedEventArgs)
    If sender.Equals(rdbtnItalic) Then
        wfh.FontStyle = FontStyles.Italic
    ElseIf UIIsReady = True Then
        wfh.FontStyle = initFontStyle
    End If

End Sub

Private Sub WeightChanged(ByVal sender As Object, ByVal e As RoutedEventArgs)
    If sender.Equals(rdbtnBold) Then
        wfh.FontWeight = FontWeights.Bold
    ElseIf UIIsReady = True Then
        wfh.FontWeight = initFontWeight
    End If

End Sub

アプリケーションをビルドして実行します。Build and run the application. Windows フォーム複合コントロールでテキストを追加し、クリックしてOKします。Add some text in the Windows Forms composite control and then click OK. そのテキストがラベルに表示されます。The text appears in the labels. コントロールに影響を表示するさまざまなオプション ボタンをクリックします。Click the different radio buttons to see the effect on the control.

関連項目See also