DesktopWindowXamlSource.ShouldConstrainPopupsToWorkArea Property

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

bool ShouldConstrainPopupsToWorkArea();

void ShouldConstrainPopupsToWorkArea(bool value);

public bool ShouldConstrainPopupsToWorkArea { get; set; }

var boolean = desktopWindowXamlSource.shouldConstrainPopupsToWorkArea;
desktopWindowXamlSource.shouldConstrainPopupsToWorkArea = boolean;

Public Property ShouldConstrainPopupsToWorkArea As Boolean

Property Value

true to constrain controls with popup-like behavior to the work area; otherwise, false. The default value is true.

Remarks

The work area of a display is the part of the desktop display that excludes task bars, docked windows, and docked tool bars. Typically, apps constrain themselves to the work area, including any controls that are opened by the app with popup-like behavior; such as Popup, Flyout, ToolTip, or a ComboBox dropdown.

If an app window is intended to be positioned outside the work area (like a docked tool bar), then its popups should not constrain themselves to the work area; otherwise they would be opened too far from the UI elements that they're associated with. This could create situations like ToolTips that open far away from the control they describe or ComboBox dropdowns that open far away from the ComboBox button.

The ShouldConstrainPopupsToWorkArea property lets you specify whether popups should be constrained to the work area. The default is true; you can specify false if your app has controls that should pop up outside the work area.

This property does not apply retroactively to popup-like controls that are already open.

Applies to