@...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



DESCRIPTION:
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:

·   Value
Set / Gets TimePicker  value.
·   Enabled
Set / Gets enabled state of a TimePicker  control
·   Visible
Set / Gets visible a TimePicker  control.
·   Row
Set / Gets row position of a TimePicker  control.
·   Col
Set / Gets column position of a TimePicker  control.
·   Width
Set / Gets width of a TimePicker  control.
·   Height
Set / Gets height of a TimePicker  control.
·   FontName
Set / Gets TimePicker control's font name.
·   FontSize
Set / Gets TimePicker control's font size.
·   FontBold
Set / Gets TimePicker control's font bold property
·   FontItalic
Set / Gets TimePicker control's font italic property
Set / Gets TimePicker control's font underline property
Set / Gets TimePicker control's font strikeout property
·   ToolTip
Set / Gets TimePicker control's tooltip text.
·   Cargo
Set / Gets user property 'Cargo' for TimePicker control
·   FormatString*)
Set / Gets the format string of a TimePicker control.
·   Name (R)
Retrieves the name of a TimePicker control.
·   Parent(D)
Set the name as character identifier of the parent window.
·   HelpId (D)
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)
Links TimePicker control to a table field.
·   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:

·   OnGotFocus
Action to be performed when getting the focus
·   OnChange
Action to be performed when generic changing of the control
Action to be performed when losing the focus.

METHODS:

·   Show
Shows a TimePicker control
·   Hide
Hides a TimePicker control
·   Redraw
Redraw a Control
·   SetFocus
Gives the focus to a TimePicker control
·   Release
Releases a TimePicker control from memory
·   Refresh
Repaint a Control
·   Save
Save data for Control TimePicker
·   SaveAs
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:

See demos in :
\Samples\Basic\DateTime