@...TIMEPICKER
DEFINE TIMEPICKER
|
@...TIMEPICKER DEFINE TIMEPICKER
|
|
Creates a timepicker control.
SYNTAX
Standard Window:
@ <nRow> ,<nCol> TIMEPICKER <ControlName>
[ ID <nId> ]
[ OF | PARENT | DIALOG <ParentWindowName> ]
[ VALUE <dValue> ]
[ FIELD <FieldName> ]
[ WIDTH <nWidth> ]
[ FONT <cFontName> SIZE <nFontSize> ]
[ BOLD ] [ ITALIC ] [ UNDERLINE ] [ STRIKEOUT ]
[ TOOLTIP <cToolTipText> ]
[ SHOWNONE ]
[ UPDOWN ]
[ TIMEFORMAT <cTimeFormat> ] // (* - see decription below)
[ ON GOTFOCUS <OnGotFocusProcedur> | <bBlock> ]
[ ON CHANGE <OnChangeProcedure> | <bBlock> ]
[ ON LOSTFOCUS <OnLostFocusProcedure> | <bBlock> ]
[ ON ENTER <OnEnterProcedure> | <bBlock> ]
[ HELPID <nHelpId> ]
[ INVISIBLE ]
[ NOTABSTOP ]
Alternate Syntax:
DEFINE TIMEPICKER <ControlName>
<PropertyName> <PropertyValue>...
<EventName> <EventProcedure> | <bBlock>...
END TIMEPICKER
PROPERTIES:
|
Set / Gets TimePicker value.
| |
|
Set / Gets enabled state of a TimePicker control
| |
|
Set / Gets visible a TimePicker control.
| |
|
Set / Gets row position of
a TimePicker control.
| |
|
Set / Gets column position of a TimePicker control.
| |
|
Set / Gets width of a TimePicker control.
| |
|
Set / Gets height of a TimePicker control.
| |
|
Set / Gets TimePicker control's font name.
| |
|
Set / Gets TimePicker control's font size.
| |
|
Set / Gets TimePicker control's font bold property
| |
|
Set / Gets TimePicker control's font italic property
| |
|
Set / Gets TimePicker control's font underline property
| |
|
Set / Gets TimePicker control's font strikeout property
| |
|
Set / Gets TimePicker control's tooltip text.
| |
|
Set / Gets user property 'Cargo' for TimePicker control
| |
|
Set / Gets the format string of a TimePicker control.
| |
|
Retrieves the name of a TimePicker control.
| |
|
·
Parent (D)
|
Set the name as character identifier of the parent window.
|
|
Set the numeric help topic identifier of the control.
| |
|
·
NoTabStop (D)
|
Sets whether an element behavior can't receive focus and participate
in the tabbing sequence
|
|
·
Field (D)
|
|
|
·
ShowNone (D)
|
Sets whether empty value is allowed in a TimePicker control
|
D: Available at control definition only
R: Read-Only
*) see decription below
EVENTS:
|
An action to be performed when getting the focus
| |
|
An action to be performed when generic changing of the control
| |
|
An action to be performed when losing the focus.
|
METHODS:
|
Shows a TimePicker control
| |
|
Hides a TimePicker control
| |
|
Gives the focus to a TimePicker control
| |
|
Releases a TimePicker control from memory
| |
|
Repaint a Control
| |
|
Save data for Control TimePicker
| |
|
Save a TimePicker control as BitMap file.
|
Remarks :
This control always return Value (as characters value) in format HH:mm:ss (8 characters long)
If SHOWNONE clause is used and shownone checkbox is unchecked - TIMEPICKER return an empty string
If no value is set this control Value is filled by current system time value
*) Characters available to format date display as TIMEFORMAT clause or FormatString property
Element Description
|
"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.
|
|
"s"
|
The one- or two-digit second.
|
|
"ss"
|
The two-digit second. Single-digit values are preceded by a zero.
|
Example:
"TIME() -> "16:22:10"
"h:mm:ss" will display time as 4:22:10
"hh:mm:ss" will display time as 04:22:10
"HH:mm:ss" will display time as 16:22:10
"HH:mm" will display time as 16:22
To make the information more readable, you can add body text to the format string
by enclosing it in single quotes. Spaces and punctuation marks do not need to be quoted.
Note: Nonformat characters that are not delimited by single quotes will result
in unpredictable display by the DTP control.
For example, to display the current time with the
format "'Now is: 16:22",
the format string is "'Now is: 'HH:mm".
To include a single quote in your body text, use two consecutive single quotes.
For example, "'Don''t forget' HH:mm" format string produces output
that looks like: Don't forget 16:22 .
EXAMPLE: