Popup.PlacementRectangle Property

Reference

Definition

Namespace:: System.Windows.Controls.Primitives

Assembly:: PresentationFramework.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

Rect

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

Attributes: BindableAttribute

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

Item	Value
Identifier field	PlacementRectangleProperty
Metadata properties set to `true`	None

Applies to

Share via