This documentation is archived and is not being maintained.

HwndHost.BuildWindowCore Method

When overridden in a derived class, creates the window to be hosted.

Namespace:  System.Windows.Interop
Assembly:  PresentationFramework (in PresentationFramework.dll)

protected abstract HandleRef BuildWindowCore(
	HandleRef hwndParent


Type: System.Runtime.InteropServices.HandleRef
The window handle of the parent window.

Return Value

Type: System.Runtime.InteropServices.HandleRef
The handle to the child Win32 window to create.

This method's implementation is called from within the internal implementation of BuildWindowCore.

The child window will be created only if the window is owned by the calling thread.

Notes to Inheritors

Override this method to build the window being hosted.

The window that you return must be a child of the window specified by hwndParent.

In addition, the child window will only be created if the window is owned by the calling thread.

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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