Skip to main content

TcxCustomDateEditProperties.View Property

Switches the dropdown calendar’s view style.

Declaration

property View: TcxCalendarView read; write; default cavDefault;

Property Value

Type Default
TcxCalendarView cavDefault

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

Meaning

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.

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.

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.

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.

The default value of the View property is cavDefault.

See Also