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

TcxCustomDateEditProperties.View Property

Switches the drop-down calendar’s view style.

#Declaration

Delphi
property View: TcxCalendarView read; write; default cavDefault;

#Property Value

Type Default Description
TcxCalendarView cavDefault

The active style of the drop-down calendar.

#Remarks

The view styles available for the dropdown calendar are listed in the table below. All these views can be optionally extended with an editor that enables editing of the time part of a date-time value and a clock visualizing this part. To accomplish this, set the Kind property to ckDateTime.

Value

Description

Example

cavModern

The modern-style calendar. It features multiple views (Month, Year, Decade, and Century) which can be activated and scrolled with smooth animation using the following methods:

  • Clicking specific days and scroll buttons;

  • Pressing the Arrow, Page Up, Page Down, Home, and End keys, the Ctrl + Up Arrow, Ctrl + Down Arrow, Ctrl + Home, and Ctrl + End key combinations;

  • Scrolling with the mouse wheel, including scrolling while holding down the Ctrl key.

You can control the visibility of the Clear and Now buttons in this calendar using the DateButtons option set. You can also control if transition animation is played when navigating dates and switch the visibility of the Today link (a Today button equivalent) using the Animation and ShowToday properties.

VCL Editors Library: A Modern-Style Drop-Down Calendar

cavClassic

The classic-style calendar. It features a single view (Month) which can be scrolled using the following methods:

  • Clicking specific days and scroll buttons;

  • Pressing the Arrow, Page Up, Page Down, Home, and End keys, the Ctrl+Up Arrow, Ctrl+Down Arrow, Ctrl+Home, and Ctrl+End key combinations;

  • Scrolling with the mouse wheel while hovering the mouse pointer over the month or year.

You can control the visibility of the Today, Clear, and Now buttons in this calendar using the DateButtons option set.

VCL Editors Library: A Classic Drop-Down Calendar

cavTouchUI

The touch-friendly calendar. It features a single view represented by a date-time wheel picker whose wheels can be scrolled to select the corresponding parts of a date-time value.

You can control the visibility of the Today, Clear, and Now buttons in this calendar using the DateButtons option set.

VCL Editors Library: A Touch-Friendly Drop-Down Calendar

cavDefault

The calendar style is selected based on the Touch mode setting. In Touch mode, the touch-friendly calendar (cavTouchUI) is used; otherwise, the modern-style calendar (cavModern).

For backward compatibility, regardless of the Touch mode setting, you can set the cxCalendarUseClassicViewAsDefault constant to `True**, to use the classic-style calendar (cavClassic) in all date editors by default.

#Default Value

The View property’s default value is cavDefault

See Also