ElementHost Class (System.Windows.Forms.Integration)

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework 3.0

.NET Framework Class Library

ElementHost Class

Updated: November 2007

A Windows Forms control that can be used to host a Windows Presentation Foundation (WPF) element.

Namespace: System.Windows.Forms.Integration
Assembly: WindowsFormsIntegration (in WindowsFormsIntegration.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/xaml/presentation

Syntax

Visual Basic (Declaration)

<ContentPropertyAttribute("Child")> _
Public Class ElementHost _
    Inherits Control

Visual Basic (Usage)

Dim instance As ElementHost

[ContentPropertyAttribute("Child")]
public class ElementHost : Control

Visual C++

[ContentPropertyAttribute(L"Child")]
public ref class ElementHost : public Control

/** @attribute ContentPropertyAttribute("Child") */
public class ElementHost extends Control

JScript

public class ElementHost extends Control

XAML Object Element Usage

<ElementHost>
  Child
</ElementHost>

Remarks

Use the ElementHost control to place a WPF UIElement on your Windows Forms control or form.

To host a Windows Forms control in a WPF element, use the WindowsFormsHost element.

Note:
WindowsFormsIntegration.dll is installed with the WPF assemblies. The default location for the assembly is %programfiles%\Reference Assemblies\Microsoft\Framework\v3.0\WindowsFormsIntegration.dll.

To host a WPF element in a Windows Form, you must assign the WPF element to the Child property.

Use the PropertyMap property to assign custom mappings between an ElementHost control and its hosted WPF element. For more information, see Windows Forms and WPF Property Mapping.

Examples

The following code example demonstrates how to use the ElementHost control to host a WPF element. For more information, see Walkthrough: Hosting a Windows Presentation Foundation Composite Control in Windows Forms.

Visual Basic

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
    ' Create the ElementHost control for hosting the
    ' WPF UserControl.
    Dim host As New ElementHost()
    host.Dock = DockStyle.Fill

    ' Create the WPF UserControl.
    Dim uc As New HostingWpfUserControlInWf.UserControl1()

    ' Assign the WPF UserControl to the ElementHost control's
    ' Child property.
    host.Child = uc

    ' Add the ElementHost control to the form's
    ' collection of child controls.
    Me.Controls.Add(host)
End Sub

Inheritance Hierarchy

System..::.Object
  System..::.MarshalByRefObject
    System.ComponentModel..::.Component
      System.Windows.Forms..::.Control
        System.Windows.Forms.Integration..::.ElementHost

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Windows Vista

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information