DateEdit.UpdateSelectionWhenNavigating Property

Gets or sets whether navigating to another month automatically selects the same range of days in that month.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v25.2.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

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

VB.NET

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

Property Value

Type	Default	Description
Boolean	false	true if the same range of days is selected when the user navigates to another month; otherwise, false.

Remarks

The UpdateSelectionWhenNavigating property requires SyncSelectionWithEditValue to be set to false.

The following animation illustrates how a selected range is transferred when navigating to a different month. If days 1–5 are selected in March and the user navigates to April, the calendar automatically selects days 1–5 in April.

The following code snippet enables automatic range transfer on navigation:

C#

using DevExpress.XtraEditors.Repository;

dateEdit1.Properties.SelectionMode = CalendarSelectionMode.Multiple;
dateEdit1.SyncSelectionWithEditValue = false;
dateEdit1.UpdateSelectionWhenNavigating = true;

VB.NET

Imports DevExpress.XtraEditors.Repository

dateEdit1.Properties.SelectionMode = CalendarSelectionMode.Multiple
dateEdit1.SyncSelectionWithEditValue = False
dateEdit1.UpdateSelectionWhenNavigating = True