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

CalendarControlBase.SelectionBehavior Property

Gets or sets whether calendar date ranges are selected strictly from day to day being clicked, or through the entire weeks containing those days.

Namespace: DevExpress.XtraEditors.Controls

Assembly: DevExpress.XtraEditors.v24.2.dll

NuGet Package: DevExpress.Win.Navigation

#Declaration

[DefaultValue(CalendarSelectionBehavior.Simple)]
[DXCategory("Behavior")]
public CalendarSelectionBehavior SelectionBehavior { get; set; }

#Property Value

Type Default Description
CalendarSelectionBehavior Simple

A CalendarSelectionBehavior enumeration value that specifies how an end-user selects date ranges.

Available values:

Name Description
Simple

Does not automatically extend the selection to the week’s start and end.

OutlookStyle

Selects entire weeks

#Remarks

If multiple dates can be selected simultaneously (see CalendarControlBase.SelectionMode), the SelectionBehavior property allows you to specify whether an end-user selects date ranges strictly from day to day being clicked (the default simple style), or the selection is automatically extended through the entire weeks containing those days (the Outlook-inspired style). See the figures below.

CalendarControlBase_SelectionBehavior_Simple CalendarControlBase_SelectionBehavior_Outlook

See Also