Property | Type | Description |
x |
integer |
x-coordinate of the upper left corner of the bar. |
y |
integer |
y-coordinate of the upper left corner of the bar. |
width |
integer |
width, in pixels, of the bar. |
height |
integer |
height, in pixels, of the bar. |
form |
string |
name of a form object that is a parent of the datetime widget (not required) |
fieldname |
string |
not used currently to my knowledge. |
sql |
string |
used to set the initial date by a query |
initialdate |
string |
used to set the initialdate by a string |
bgcolor |
string |
the background color of the bar and pane. (named or numeric) |
fgcolor |
string |
the foreground color of the bar and pane. (named or numeric) |
search_by_range |
yes/no |
Default "yes". Specifies that when the datetime widget is in a form that is in search (QBF) mode, the datetime should display both a "start" and an "end" calendar so the user can search for records/objects matching a range of dates. |
date_only |
yes/no |
Default "no". If set to "yes" indicates that the datetime widget should only allow select and display a date, not a date and time. It may be useful to set default_time when using this option. |
default_time |
string |
When the user sets the date without selecting a time value (or if date_only is set), use this time as the "default" time. This can be set to "00:00:00" or "23:59:59", for example, to specify a time at the start or end of a day. |
Event | Description |
Click |
This event occurs when the user clicks the widget. No parameters are available from this event. |
MouseUp |
This event occurs when the user releases the mouse button on the widget. |
MouseDown |
This event occurs when the user presses the mouse button on the widget. This differs from the 'Click' event in that the user must actually press and release the mouse button on the widget for a Click event to fire, whereas simply pressing the mouse button down will cause the MouseDown event to fire. |
MouseOver |
This event occurs when the user first moves the mouse pointer over the widget. It will not occur again until the user moves the mouse off of the widget and then back over it again. |
MouseOut |
This event occurs when the user moves the mouse pointer off of the widget. |
MouseMove |
This event occurs when the user moves the mouse pointer while it is over the widget. The event will repeatedly fire each time the pointer moves. |
DataChange |
This event occurs when the user has modified the data value of the widget (clicked or unclicked it). |
LoseFocus |
This event occurs when the datetime widget loses keyboard focus (if the user tabs off of it, for instance). |
GetFocus |
This event occurs when the datetime widget receives keyboard focus (if the user tabs on to it or clicks on it, for instance). |