Popup.PlacementRectangle Property

Definition

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

public:
 property System::Windows::Rect PlacementRectangle { System::Windows::Rect get(); void set(System::Windows::Rect value); };
[System.ComponentModel.Bindable(true)]
public System.Windows.Rect PlacementRectangle { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.PlacementRectangle : System.Windows.Rect with get, set
Public Property PlacementRectangle As Rect

Property Value

The rectangle that is used to position the Popup control. The default is null.

Attributes

Examples

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>

Remarks

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

Dependency Property Information

Identifier field PlacementRectangleProperty
Metadata properties set to true None

Applies to

See also