Popup.StaysOpen 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 a value that indicates whether the Popup control closes when the control is no longer in focus.

public:
 property bool StaysOpen { bool get(); void set(bool value); };

[System.ComponentModel.Bindable(true)]
public bool StaysOpen { get; set; }

[<System.ComponentModel.Bindable(true)>]
member this.StaysOpen : bool with get, set

Public Property StaysOpen As Boolean

Property Value

Boolean

true if the Popup control closes when IsOpen property is set to false; false if the Popup control closes when a mouse or keyboard event occurs outside the Popup control. The default is true.

Attributes: BindableAttribute

Examples

The following example shows how to set the StaysOpen property.

myTextBlockPopup.StaysOpen = true;

myTextBlockPopup.StaysOpen = True

<DockPanel  Width="500" Background="Aqua">
  <Popup Placement="Center" PlacementRectangle="0,0,30,50"  
          IsOpen ="True" StaysOpen="True"
          PopupAnimation="Fade">
    <TextBlock Background="Purple">Popup Text</TextBlock>
  </Popup>
</DockPanel>

Remarks

When the StaysOpen property is set to true, Popup stays open until it is explicitly closed by setting the IsOpen property to false. When StaysOpen is false, the Popup control intercepts all mouse and keyboard events to determine when one of these events occurs outside the Popup control.

Dependency Property Information

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

Applies to

Jaa