BCGDateTime controls version 1.0
4.63/5 (8 votes)
Jan 27, 2000
109316
3055
A set of four date/time ActiveX controls (Date/Time Picker, Month Calendar, Duration Control, Time Intervals Control)
Please see Stas Levin's Page for the latest updates, discussion board, and FAQ.
Introduction
BCGDateTime is a set of four date/time ActiveX controls (Date/Time Picker, Month Calendar, Duration Control, Time Intervals Control)
BCGDateTime Features
BCGDateTime is a set of four ActiveX date/time and calendar controls.
- Date/Time Picker allows you enter date/time together in the one control;
- Month Calendar allows create your own organizers with single/multiply day selection both in weekly and monthly mode, mark several days, enable specific time interval;
- Duration Control allows you edit an event duration such as "3 days 10 hours 15 minutes". Fully configurable!
- Time Intervals Control allows you define some daily time intervals such as 10:00AM-10:20AM, 3PM-5:30PM
All controls are automatically obtain date/time system formats from the customer computer settings.
How to use BCGDateTime controls
Installation notes:
- Unzip BCGTimeControls.zip file (e.g. c:\bcg directory)
- Go to output\release directory and register all controls (regsvr32 BCGDateTime.ocx, regsvr32 BCGDurationCtrl.ocx and regsvr32 BCGTimeIntervals.ocx)
- Run BCGTimeExample.exe
Date/Time Control Properties and Methods:
| Name | Description |
| Date Date | Date/Time value |
| DATE MinDate | Min. allowed date |
| DATE MaxDate | Max. allowed date |
| boolean CheckButton | Show check box |
| boolean DropCalendar | Show Drop-down calendar arrow |
| boolean ShowDate | Show control's date part |
| boolean ShowTime | Show control's time part |
| boolean SpinButton | Show up/down arrows |
| boolean WantReturn | If WantReturn is true, control catches ENTER/ESC keys and fires OnEnter/OnCancel events |
| void SizeToContent() | Adjust control size according to attributes. Should be called in OnInitDialog (VB - Form_Load) |
Date/Time Control Events:
| Name | Description |
| OnDateChanged | Indicates that Date property was changed |
| OnSetFocus | Indicates that control received focus |
| OnKillFocus | Indicates that control lost focus |
| OnEnter | Enter key was pressed (fired if WantReturn property is true) |
| OnCancel | Esc key was pressed (fired if WantReturn property is true) |
Calendar Control Properties and Methods:
| Name | Description |
| boolean MultiplySelection | Allow multiply days selection |
| boolean AbsoluteSelectionMode | When this property is true, the selected days are saved when user changes the month; otherwise, control saves the weekdays |
| OLE_COLOR BackgroundColor | Calendar background color |
| OLE_COLOR ForegroundColor | Calendar foreground color |
| OLE_COLOR SelectionBackgroundColor | Background color of the selected days |
| OLE_COLOR SelectionForegroundColor | Foreground color of the selected days |
| OLE_COLOR LightColor | 3-d edges light color |
| OLE_COLOR ShadowColor | 3-d edges shadow color |
| void SetSelectedDay(short iDay) | Select the day (1-31) |
| void ClearAllSelections() | Clear all day selections |
| boolean IsDaySelected(short iDay) | Is day (1-31) selected? |
| boolean MarkDay(short iDayNum, boolean bMarked) | Mark the specific day (marked day is displayed as bold+underline) |
| void UnMarkAllDays() | Clear all day marks |
Calendar Control Events:
| Name | Description |
| OnSelectionChanged | Indicates that selection was changed |
| OnDateChanged | Indicates that date was changed (relevant if MultiplySelection property is false) |
| OnMonthChanged | Indicates that month/year was changes |
Duration Control Properties and Methods:
| Name | Description |
| long TotalSeconds | Duration |
| boolean SpinButton | Show up/down arrows |
| BSTR DaysLabel | Text appeares after the days number (default: "Day(s) ") |
| BSTR HoursLabel | Text appeares after the hours number (default: ":") |
| BSTR MinutesLabel | Text appeares after the minutes number (default is empty) |
| boolean ShowDays | Show number of days |
| boolean ShowHoursMinutes | Show hours/minutes part |
| void SizeToContent() | Adjust control size according to attributes. Should be called in OnInitDialog (VB - Form_Load) |
Duration Control Events:
| Name | Description |
| void OnDurationChanged(long lTotalSeconds) | Indicates that duration was changed |
Time Intervals Control Properties and Methods:
| Name | Description |
| boolean MergingIsAllowed | Time intervals automerge is allowed |
| boolean MultiplySelection | Multiple selection is allowed |
| OLE_COLOR IntervalColor | Interval background color |
| OLE_COLOR IntervalTextColor | Interval foreground color |
| OLE_COLOR BackgroundColor | Control background color |
| OLE_COLOR ForegroundColor | Control foreground color |
| boolean AddInterval(DATE dateFrom, DATE dateTo, short iStatus) | Add a new time interval (remark: date part of DATE-type parameters are ignored). Interval's color will be defined according to interval's status (see SetStatusColor method) |
| boolean ChangeInterval(short iIndex, DATE dateFrom, DATE dateTo, short iStatus) | Changes the specific time interval |
| boolean RemoveInterval(short index) | Remove the specific time interval |
| void RemoveAllIntervals() | Remove all time intervals |
| short GetIntervalsCount() | Returns intervals count |
| boolean GetInterval(short iIndex, DATE* dateFrom, DATE* dateTo, short* iStatus) | Obtain the specific interval data |
| boolean SetIntervalStatus(short iIndex, short iStatus) | Set the specific interval status. Interval's color will be defined according to interval's status (see SetStatusColor method) |
| void SetStatusColor(short iStatus, OLE_COLOR color) | Set the specific status's color. All time intervals with the given status will be drawn with this background color |
| short GetCurSel() | Returns selected interval number or (-1) if no intervals is selected |
| boolean SetCurSel(short index) | Select the specific interval |
Time Intervals Control Events:
| Name | Description |
| OnAddInterval(short index, DATE FromTime, DATE ToTime) | New time interval was added by user |
| OnChangeInterval(short index, DATE FromTime, DATE ToTime) | Time interval was moved by user |
| OnRemoveInterval(DATE FromTime, DATE ToTime) | Time interval was removed by user |
| OnSelectionChanged(short index) | Selection was changed |
Requirements
MS Visual C++ 5.0 with the SP3 This code can be used WITHOUT ANY WARRANTIES on your own risk. You can send bug reports and suggestions to Stas Levin.
Copyright and use
BCGDateTime controls are freeware software. You may use, compile or redistribute it as part of your application for free. You cannot redistribute it as a part of a software development library without the agreement of the author. If the sources are distributed along with the application, you should leave the original copyright notes in the source code without any changes.