Popup.PlacementRectangle Property

Gets or sets the rectangle relative to which the Popup control is positioned when it opens.

Namespace:  System.Windows.Controls.Primitives
Assembly:  PresentationFramework (in PresentationFramework.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

'Declaration
<BindableAttribute(True)> _
Public Property PlacementRectangle As Rect
<object>
  <object.PlacementRectangle>
    <Rect .../>
  </object.PlacementRectangle>
</object>
<object PlacementRectangle="Rect" .../>

Property Value

Type: System.Windows.Rect
The rectangle that is used to position the Popup control. The default is Nothing.

Identifier field

PlacementRectangleProperty

Metadata properties set to true

None

You can position a popup by setting the PlacementTarget, PlacementRectangle, Placement, HorizontalOffset, and VerticalOffsetProperty properties. For more information, see Popup Placement Behavior.

The following example sets the PlacementRectangle property of a Popup. The X, Y, Width, and Height properties of the PlacementRectangle are 50, 50, 50, and 100, respectively. The Popup is relative to the bounds of the PlacementRectangle property. Note that the PlacementRectangle property does not create a visible element in the application; the example creates a Rectangle with the same bounds to represent the PlacementRectangle.

<Canvas Width="200" Height="200" Background="Red">
  <Rectangle Canvas.Top="50" Canvas.Left="50" 
             Width="50" Height="100"
             Stroke="White" StrokeThickness="3"/>
  <Popup IsOpen="True" PlacementRectangle="50,50,50,100">
    <TextBlock FontSize="14" Background="Yellow"
               Width="140" TextWrapping="Wrap">
      This is a popup with a PlacementRectangle.
    </TextBlock>
  </Popup>
</Canvas>

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft