| Home | Translations | Download | Forum | Bug Tracker

|  | v1.3.7

DateTime Picker
The DateTime Picker control allows users to select a date or time in a neat way, automatically enclosing the calendar control and also providing UpDown spinners on date/time values. It is highly recommended that you familiarise yourself with how the mIRC functions $ctime and $asctime() functions work before using this control.
Control Styles
These control styles are available when creating a DateTime Picker control. Remember that the general styles disabled, group, notheme, tabstop and transparent apply to all DCX controls.
longdateformat | The date will be displayed in a long format, which produces a result like Friday, April 19, 1996.
right | The text value will be aligned to the right.
shortdatecenturyformat | The date will be similar to the shortdateformat, however the result will include the century like 4/19/1996.
shortdateformat | The date will be displayed in a short format, which produces a result like 4/19/96.
shownone | It is possible to have no date selected in the control. The user MUST select the checkbox, otherwise it will return no date.
timeformat | Displays the time like 5:31:42 PM.
updown | Places an up-down control to the right of the DTP control to modify date-time values.
/xdid flags
Control commands are input to the control with the /xdid command.
/xdid -f
This command lets you set format of the DateTime Picker text.
Syntax: | /xdid -f [DNAME] [ID] [FORMAT]
Example: | /xdid -f dcx 4 'Right now it is: 'hh':'m':'s ddddMMMdd', 'yyy
Parameters:
FORMAT | Date time format options.
d | The one- or two-digit day.
dd | The two-digit day. Single-digit day values are preceded by a zero.
ddd | The three-character weekday abbreviation.
dddd | The full weekday name.
h | The one- or two-digit hour in 12-hour format.
hh | The two-digit hour in 12-hour format. Single-digit values are preceded by a zero.
H | The one- or two-digit hour in 24-hour format.
HH | The two-digit hour in 24-hour format. Single-digit values are preceded by a zero.
m | The one- or two-digit minute.
mm | The two-digit minute. Single-digit values are preceded by a zero.
M | The one- or two-digit month number.
MM | The two-digit month number. Single-digit values are preceded by a zero.
MMM | The three-character month abbreviation.
MMMM | The full month name.
t | The one-letter AM/PM abbreviation (that is, AM is displayed as "A").
tt | The two-letter AM/PM abbreviation (that is, AM is displayed as "AM").
yy | The last two digits of the year (that is, 1996 would be displayed as "96").
yyyy | The full year (that is, 1996 would be displayed as "1996").
Note. Any non-format characters must be enclosed within single quotes. A DTP control tracks locale changes when it is using the default format string.
/xdid -r
This command lets you set the range of the first and last selectable dates.
Syntax: | /xdid -r [DNAME] [ID] [MIN_TIMESTAMP] [MAX_TIMESTAMP]
Example: | /xdid -r dcx 4 $ctime(3rd July 2006) $ctime /xdid -r dcx 4 nolimit $ctime
Note. You can use nolimit for MIN_TIMESTAMP or MAX_TIMESTAMP if you wish to specify no minimum or maximum date range respectively.
/xdid -t
This command lets you set the selected date/time.
Syntax: | /xdid -t [DNAME] [ID] [TIMESTAMP]
Example: | /xdid -t dcx 4 $ctime(3rd July 3006)
Note. You can use reset for TIMESTEMP to set it back to the current date/time, but this only applies to the shownone style.
$xdid() Properties
The $xdid identifier is a given mIRC alias that communicates with the DCX DLL to extract information in DCX controls.
$xdid().range
This property lets you retreive the date/time range.
Syntax: | $xdid(dialog, ID).range
Example: | $xdid(dcx, 4).range
Note. nolimit is returned when the calendar range is not bounded.
$xdid().value
This property lets you retreive the selected date/time.
Syntax: | $xdid(dialog, ID).value
Example: | $xdid(dcx, 4).value
| Control Styles longdateformat right shortdatecenturyformat shortdateformat shownone timeformat updown /xdid Flags -f -r -t $xdid() Properties range value

Contact | © 2005-2006 | Last Updated: 14th January, 07