@...TIMEPICKER
DEFINE TIMEPICKER
Create a TimePicker control
|
@...TIMEPICKER DEFINE TIMEPICKER Create a TimePicker control
|
|
Creates a TimePicker control.
SYNTAX
Standard Window:
@ <nRow> ,<nCol> TIMEPICKER <ControlName>
[ ID <nId> ]
[ OF | PARENT | DIALOG <ParentWindowName> ]
[ VALUE <dValue> ]
[ FIELD <FieldName> ]
[ WIDTH <nWidth> ]
[ HEIGHT <nHeight> ]
[ FONT <cFontName> SIZE <nFontSize> ]
[ BOLD ] [ ITALIC ] [ UNDERLINE ] [ STRIKEOUT ]
[ TOOLTIP <cToolTipText> ]
[ SHOWNONE ]
[ UPDOWN ]
[ TIMEFORMAT <cTimeFormat> ] // (* - see decription below)
[ ON GOTFOCUS <OnGotFocusProcedure> | <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
|
nRow, nCol
|
Position in the area of ??the window in pixels.
|
|
nWidth, nHeight
|
The desired size of the TimePicker Control in pixels.
|
|
nId
|
The ID identifier this Control in Dialog Window
|
|
ControlName
|
A reference to the TimePicker Control
|
|
ParentWindowName
|
A reference to the Parent Window.
|
|
nHelpID
|
The help topic identifier for this Control
|
|
FieldName
|
|
|
cFontName
|
Specifies the Font Name
|
|
cFontSize
|
Specifies the Font Size
|
|
cToolTipText
|
Specifies the Text for the ToolTip
|
|
cTimeFormat
|
Specifies the Time format
|
|
OnGotFocusProcedure
|
An action to be performed when control Got Focused
|
|
OnChangeProcedure
|
An action to be performed when control value Changes
|
|
OnLostFocusProcedure
|
An action to be performed when control Lost Focused
|
|
OnEnterProcedure
|
An action to be performed when control is pressed ENTER
|
|
|
|
|
SHOWNONE
|
?
|
|
UPDOWN
|
?
|
|
INVISIBLE
|
The visibility property specifies whether or not a control is
visible
|
|
NOTABSTOP
|
Stop the control to receive focus and participate in the
tabbing sequence
|
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.
| |
|
Set the name as character identifier of the parent window.
| |
|
Set the numeric help topic identifier of the control.
| |
|
Sets whether an element behavior can't receive focus and participate
in the tabbing sequence
| |
|
Links TimePicker control to a table field.
| |
|
Sets whether empty value is allowed in a TimePicker control
|
D: Available
at control definition only
R: Read-Only
*) see decription below
EVENTS:
|
Action to be performed when getting the focus
| |
|
Action to be performed when generic changing of the control
| |
|
Action to be performed when losing the focus.
|
METHODS:
|
Shows a TimePicker control
| |
|
Hides a TimePicker control
| |
|
Redraw a 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: