This documentation is archived and is not being maintained.

Popup.CreateRootPopup Method

Attaches a child element to a Popup control.

Namespace:  System.Windows.Controls.Primitives
Assembly:  PresentationFramework (in PresentationFramework.dll)

public static void CreateRootPopup(
	Popup popup,
	UIElement child


Type: System.Windows.Controls.Primitives.Popup
The Popup to which to add child content.
Type: System.Windows.UIElement
The UIElement child content.

You might want to create a custom control that has the same functionality as an existing control and also exhibits the behavior of a Popup. You can make your control behave like a Popup by adding a Popup to your control and calling the CreateRootPopup method.

This method assigns child to the child property and binds the following properties to child.

You should implement these as dependency properties in your control so it can be used the same way as a Popup. For more information, see Custom Dependency Properties.

When you call CreateRootPopup, child cannot be a child of a UIElement. Also, PlacementTarget should be set on your control before you call this method.

.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.