Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Popup.Placement Property

Gets or sets the orientation of the Popup control when the control opens, and specifies the behavior of the Popup control when it overlaps screen boundaries.

Namespace: System.Windows.Controls.Primitives
Assembly: PresentationFramework (in presentationframework.dll)
XML Namespace:  http://schemas.microsoft.com/winfx/2006/xaml/presentation

[BindableAttribute(true)] 
public PlacementMode Placement { get; set; }
/** @property */
public PlacementMode get_Placement ()

/** @property */
public void set_Placement (PlacementMode value)

public function get Placement () : PlacementMode

public function set Placement (value : PlacementMode)

<object Placement="PlacementMode" .../>

Property Value

A PlacementMode enumeration value that determines the orientation of the Popup control when the control opens, and that specifies how the control interacts with screen boundaries. The default value is Bottom.

Identifier field

PlacementProperty

Metadata properties set to true

None

This set of examples shows how to use the placement properties to specify the position of a Popup control.

You can determine the position of a Popup control by using the following properties:

The first four properties define a two-dimensional coordinate on the screen. The fifth property, Placement, positions the Popup and also defines its behavior if its content overlaps the screen boundaries.

Use a PlacementMode enumeration value to set the Placement property. For more information about the enumeration values for PlacementMode, see How to: Use the PlacementMode Enumeration to set Placement.

The following illustrations show how the placement properties work together to position a Popup control.

Popup placement by using the Placement property


Popup placement

Popup placement by using the Placement and PlacementRectangle properties


Popup placement rectangle

Popup placement by using the Placement, PlacementRectangle, and Offset properties


Popup placement diagram

The following example shows how to set these Popup properties. For the complete sample, see Popup Position Sample.

Popup myPopup = new Popup();
myPopup.PlacementTarget = myEllipse;
myPopup.PlacementRectangle = new Rect(0, 0, 30, 50);
myPopup.VerticalOffset = 20;
myPopup.HorizontalOffset = 20;
myPopup.Placement = PlacementMode.Bottom;
myPopup.PopupAnimation = PopupAnimation.Fade;
myPopup.AllowsTransparency = true;
TextBlock popupText = new TextBlock();
popupText.Background = Brushes.Beige;
popupText.FontSize = 12;
popupText.Width = 75;
popupText.TextWrapping = TextWrapping.Wrap;
myPopup.Child = popupText;

More Code

How to: Set the Placement Property for a Popup or Tooltip

This example shows how the PlacementMode enumeration values help you position a Popup or a tooltip control. Use the PlacementMode enumeration values to set the Popup.Placement, ToolTip.Placement, and ToolTipService.Placement properties.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft