CALENDAR dialog element

Windows Linux macOS

Syntax

DIALOG ADD,CALENDAR,<name>,<top>,<left>,<width>,<height>,<value>,<tooltip>,<styles>

Description

This dialog element creates a calendar at the position and size specified, set to the date <value>. If <value> is not specified, the calendar is set to today's date.

[VDS5] The date cannot be set using the DIALOG ADD command. The date may only be set using a DIALOG SET command, with the date in the format mm/dd/yyyy. The selected date may be read using the @DLGTEXT function, and is returned in the form mm|dd|yyyy, in a format suitable for parsing into separate variables using the PARSE command. Note that the information returned by this dialog element ignores the field separator selection made using OPTION FIELDSEP.

[VDS6] The date values used by this dialog element are floating-point values compatible with the @DATETIME function, which may be used to convert to and from a readable date format.

Styles

In addition to user-defined styles to change the default font style and color, the following styles may be used with this dialog element:

CLICK The element will generate a <name>CLICK event when clicked with the mouse.
NOBORDER The calendar will be drawn with a flat style.
NOGRID The calendar will be drawn without the grid lines.
<cursor style> The cursor will change to the named style when the pointer is over the dialog element. Valid styles are: NONE, ARROW, CROSS, IBEAM, SIZE, NESW, NS, NWSE, WE, UP, WAIT, DRAG, NODROP, HSPLIT, VSPLIT, MULTI, SQL, NO, HELP, HAND.

Example

DIALOG ADD,CALENDAR,CALENDAR1,120,16,200,100,@datetime(,31/5/2005)
info Date selected: @datetime(d mmmm yyyy,@dlgtext(calendar1))

See also