| Reference > TDBCalendar Control > TDBCalendar Control Properties > StartOfMonth Property (TDBCalendar) |
The StartOfMonth property takes effect only when there are 12 months displayed within the current view. This is very useful for creating special year views such as fiscal years.
TDBCalendar.StartOfMonth= value
Read/Write at run time and design time.
|
Design Time |
Run Time |
|
0 - Default (Default) |
dbiMonthDefault |
|
1 - January |
dbiMonthJanuary |
|
2 - February |
dbiMonthFebruary |
|
3 - March |
dbiMonthMarch |
|
4 - April |
dbiMonthApril |
|
5 - May |
dbiMonthMay |
|
6 - June |
dbiMonthJune |
|
7 - July |
dbiMonthJuly |
|
8 - August |
dbiMonthAugust |
|
9 - September |
dbiMonthSeptember |
|
10 - October |
dbiMonthOctober |
|
11 - November |
dbiMonthNovember |
|
12 - December |
dbiMonthDecember |
If set to 0-Default the month specified with the Value property will be displayed in the upper left position only if the value does not contain within the current view area. Setting this option will behave just like when displaying less than 12 months. Clicking on the month scroll bar buttons will scroll the calendar by the amount specified with the ScrollRate property. Moving off the last month using the keyboard or dragging the mouse will always cause the scrolling of the view.
However, if set to 1-January through 12-December, the specified month will be displayed on the upper left position. Clicking on the month scroll bar buttons or dragging with the mouse will always scroll a year at a time regardless to the ScrollRate setting. Also navigating off the last month will cause the focus to move back to the upper left month. Note that the first month displayed in the view will not change in any case.
With a fixed starting month, when reaching the maximum or the minimum year, the months out of the appropriate range will be treated equivalent as the trailing days. Users will not be able to move the focus (change the value) upon these days.
When the StartOfMonth property is set to 0-Default, changing the Value property will cause the new month to display on the upper left position only if the new value does not contain in the current view. However, if the value already exist within the current view, the upper left month will not be changed and the specified date will be selected.