This topic has not yet been rated - Rate this topic

Popup.StaysOpen Property

.NET Framework 4

Updated: July 2010

Gets or sets a value that indicates whether the Popup control closes when the control is no longer in focus.

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

Syntax

C++

Copy

[BindableAttribute(true)]
public bool StaysOpen { get; set; }

XAML Attribute Usage

Copy

<object StaysOpen="bool" .../>

Property Value

Type: System.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.

Dependency Property Information

Identifier field	StaysOpenProperty
Metadata properties set to true	None

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.

Examples

The following example shows how to set the StaysOpen property.

Copy


myTextBlockPopup.StaysOpen = true;

XAML

Copy


<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>

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.