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

Declaration

C#

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

VB.NET

<DefaultValue(False)>
<DXCategory("Behavior")>
Public Property AllowOverlayResize As Boolean

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

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.

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.