Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

NavigationPane.AllowOverlayResize Property

Gets or sets whether or not all clicks made close to the page border should be handled by the NavigationPane instead of controls lying on top of this page.

Namespace: DevExpress.XtraBars.Navigation

Assembly: DevExpress.XtraBars.v24.2.dll

NuGet Package: DevExpress.Win.Navigation

#Declaration

[DefaultValue(false)]
[DXCategory("Behavior")]
public bool AllowOverlayResize { get; set; }

#Property Value

Type Default Description
Boolean false

true if all clicks made close to the page border should be handled by the NavigationPane; otherwise, false.

#Remarks

You can build the content of your NavigationPage in such way that clickable UI elements are very close to the control’s side edge (see the figure below).

NavigationPane - Overlay 1

This can lead to issues like one in the following figure. The mouse pointer hovers the right control edge. Normally, you would expect to be able to click here and drag the border sideways to resize the page. However, since the data grid control lays on top of your page, your drag-and-drop will be intercepted by a grid column. As a result, you will resize this column instead of a page. To resize the page, you will be forced to move your mouse pointer to the right, pixel-by-pixel, trying to target the outer border of the NavigationPane, not a grid column header.

NavigationPane - Overlay 2

To avoid this pixel hunting, enable the AllowOverlayResize property. By doing so, you force all clicks made close to the page border to be handled by the NavigationPane, not other controls in the way. Then, increase the numeric NavigationPane.OverlayResizeZoneThickness property value to enlarge this overlay zone. For example, the following figure illustrates the same sample, but with the overlay resize zone thickness set to 30.

NavigationPane - Overlay 3

See Also