Walkthrough: hospedando um controle em um aplicativo WPF Formulários do Windows de terceiros

Artigo
08/01/2011

This walkthrough shows you how to use the WPF Designer for Visual Studio to host a Windows Forms third-party vendor control in a WPF application. For more information about Windows Forms and WPF interoperability, see Migração e Interoperabilidade.

In this walkthrough, you will use a MonthCalendar control to represent a third-party vendor control. You create a UserControl type which has an instance of the MonthCalendar control in its Controls collection. The UserControl type exposes a Date property and implements custom logic to define the MonthCalendar control's behavior. In the WPF application, a TextBlock element is bound to the Date property.

In this walkthrough, you perform the following tasks:

Create the WPF project.
Create a Windows Forms user control to encapsulate the vendor control.
Host the Windows Forms user control in a WPF application.

The following illustration shows how your application will appear.

Controle hospedado do Window Forms

Observação
Caixas de diálogo e comandos de menu que você vê podem diferir das descritas na Help dependendo das suas configurações ativas ou edição. Para alterar as configurações, escolha Import and Export Settings sobre o Ferramentas menu. For more information, see Trabalhando com configurações.

Pré-requisitos

You need the following components to complete this walkthrough:

Visual Studio 2010.

Creating the WPF Project

The first step is to create the WPF project for the host application.

To create the project

Create a new WPF Application project in Visual Basic or Visual C# named HostingMonthCalendar. For more information, see Como: Criar um novo projeto de aplicativo WPF.

MainWindow. XAML é aberto no WPF Designer.
In Solution Explorer, add a reference to the WindowsFormsIntegration assembly, which is named WindowsFormsIntegration.dll.

Creating the Windows Forms Composite Control

This procedure shows how to create a composite control by deriving a type from the UserControl class.

To create the Windows Forms composite control

Add a new Windows Forms Control Library project in Visual Basic or Visual C# named VendorControlLibrary to the solution. For more information, see Como: Adicionar e remover itens de solução.

UserControl1 opens in the Windows Forms Designer
In Solution Explorer, right-click the UserControl1 file, and select Rename.
Change the name of the control to VendorControl. When you are asked if you want to rename all references, click Yes.
On the design surface, select the VendorControl.
No Propriedades janela, defina o valor da Size propriedade para 200,200.
From the Toolbox, double-click the MonthCalendar control.

A MonthCalendar control appears on the design surface.
In the Properties window, set the following properties for the MonthCalendar control.

Property

Value

Margin

0,0,0,0

ShowToday

False
Definir o tamanho do VendorControl para adequar o tamanho da MonthCalendar de controle.
Select the MonthCalendar control.
No janela Propriedades, clique na guia eventos e um duplo clique de-a DateChanged evento.

O arquivo de VendorControl abre no Editor de Código e um manipulador de evento para o DateChanged evento é adicionado.

Property	Value
Margin	0,0,0,0
ShowToday	False

Replace the existing code with the following code. This code defines a Date property and some logic for restricting the MonthCalendar control's date range properties, SelectionStart and SelectionEnd, to the same value as TodayDate. This code also implements the INotifyPropertyChanged interface, which is used in WPF data binding.

Imports System
Imports System.Collections.Generic
Imports System.ComponentModel
Imports System.Drawing
Imports System.Data
Imports System.Linq
Imports System.Text
Imports System.Windows.Forms

Public Class VendorControl
    Inherits UserControl
    Implements INotifyPropertyChanged

    <Browsable(True)> _
    Public Property [Date]() As String
        Get
            Return Me.MonthCalendar1.TodayDate.ToShortDateString()
        End Get

        Set(ByVal value As String)
            If value <> Me.MonthCalendar1.TodayDate.ToShortDateString() Then
                Dim newDate As DateTime = DateTime.Parse(value)
                Me.SetDate(newDate)
                Me.NotifyPropertyChanged("Date")
            End If
        End Set
    End Property


    Private Sub monthCalendar1_DateChanged( _
        ByVal sender As Object, ByVal e As DateRangeEventArgs) _
    Handles MonthCalendar1.DateChanged
        Me.SetDate(e.Start)
        Me.NotifyPropertyChanged("Date")

    End Sub


    Private Sub SetDate(ByVal [date] As DateTime)
        Me.MonthCalendar1.TodayDate = [date]
        Me.MonthCalendar1.SelectionStart = [date]
        Me.MonthCalendar1.SelectionEnd = [date]

    End Sub

#Region "INotifyPropertyChanged Implementation"

    Public Event PropertyChanged As PropertyChangedEventHandler _
        Implements INotifyPropertyChanged.PropertyChanged

    Private Sub NotifyPropertyChanged(ByVal info As String)
        RaiseEvent PropertyChanged(Me, New PropertyChangedEventArgs(info))
    End Sub

#End Region
End Class

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Drawing;
using System.Data;
using System.Linq;
using System.Text;
using System.Windows.Forms;

namespace VendorControlLibrary
{
    public partial class VendorControl : UserControl, INotifyPropertyChanged
    {
        public VendorControl()
        {
            InitializeComponent();
        }

        [Browsable(true)]
        public string Date
        {
            get
            {
                return this.monthCalendar1.TodayDate.ToShortDateString();
            }

            set
            {
                if (value != this.monthCalendar1.TodayDate.ToShortDateString())
                {
                    DateTime newDate = DateTime.Parse(value);
                    this.SetDate(newDate);
                    this.OnPropertyChanged("Date");
                }
            }
        }

        private void monthCalendar1_DateChanged(object sender, DateRangeEventArgs e)
        {
            this.SetDate(e.Start);
            this.OnPropertyChanged("Date");
        }

        private void SetDate(DateTime date)
        {
            this.monthCalendar1.TodayDate = date;
            this.monthCalendar1.SelectionStart = date;
            this.monthCalendar1.SelectionEnd = date;
        }

        #region INotifyPropertyChanged Implementation

        public event PropertyChangedEventHandler PropertyChanged;

        private void OnPropertyChanged(string propertyName)
        {
            if (this.PropertyChanged != null)
            {
                this.PropertyChanged(this, new PropertyChangedEventArgs(propertyName));
            }
        }

        #endregion
    }
}

On the Build menu, select Build Solution to build the solution.

Hosting the Windows Forms Control in WPF

You use the WindowsFormsHost element to host VendorControl in a WPF application.

To host the Windows Forms control in WPF

In the HostingMonthCalendar project of Solution Explorer, add a reference to the VendorControlLibrary project. For more information, see Como: Adicionar ou remover referências no Visual Studio.
Abrir MainWindow. XAML na WPF Designer.
From the Toolbox, drag a WindowsFormsHost control onto the design surface.

Uma referência ao assembly chamado WindowsFormsIntegration. dll é adicionada ao projetode HostingMonthCalendar.

In XAML view, replace the existing markup with the following markup. Esse XAML mapeia o VendorControlLibrarynamespace e ligações um TextBlock elemento para o Datedepropriedade em VendorControl.

<Window x:Class="HostingMonthCalendar.MainWindow"
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:v="clr-namespace:VendorControlLibrary;assembly=VendorControlLibrary"
    Title="Window1" Height="300" Width="300">
    <Grid>
        <Grid.RowDefinitions>
            <RowDefinition Height="Auto" />
            <RowDefinition />
        </Grid.RowDefinitions>

        <WindowsFormsHost Name="Host" Grid.Row="0" HorizontalAlignment="Center" VerticalAlignment="Center">
            <v:VendorControl Date="2/2/03" />
        </WindowsFormsHost>

        <TextBlock Grid.Row="1" 
                   Text="{Binding ElementName=Host, Path=Child.Date, Mode=OneWay, UpdateSourceTrigger=PropertyChanged }" 
                   HorizontalAlignment="Stretch" 
                   VerticalAlignment="Center" 
                   TextAlignment="Center" 
                   TextDecorations="None" 
                   FontSize="24" />
    </Grid>
</Window>

From the Debug menu, select Start Debugging.
Click the MonthCalendar control to change the current date. The WPF TextBlock element updates to display the selected date.

Próximas etapas

If your control will be widely used in a WPF environment, you can derive your own class from WindowsFormsHost and expose the Date property. This enables other WPF controls to bind directly to the Date property, without using the Path=Child.Date syntax.
You can also host WPF controls in Windows Forms. For more information, see Usando os controles do WPF.

Consulte também

Histórico de alterações

Date	History	Motivo
Setembro de 2010	Etapa adicional de ausente.	Comentários do cliente.

Setembro de 2010

Etapa adicional de ausente.

Comentários do cliente.

Compartilhar via