@...TIMEPICKER \/ DEFINE TIMEPICKER

Creates a TimePicker control

Standard Syntax (xBase Style):

 @ <nRow> ,<nCol>
 TIMEPICKER<ControlName>
 [ OF | PARENT <cParentWindowName> ]
 [ VALUE <cValue> ]
 [ FIELD <FieldName> ]
 [ FORMAT <cTimeFormat>]
 [ WIDTH <nWidth> ]
 [ HEIGHT <nValue> ]
 [ FONT <cFontName> SIZE <nFontSize> ]
 [ BOLD ] [ ITALIC ] [ UNDERLINE ] [ STRIKEOUT ]
 [ TOOLTIP <cToolTipText> ]
 [ SHOWNONE ]
 [ ON GOTFOCUS <OnGotFocusProcedur> | <bBlock> ]
 [ ON CHANGE <OnChangeProcedure> | <bBlock> ]
 [ ON LOSTFOCUS <OnLostFocusProcedure> | <bBlock> ]
 [ HELPID <nHelpId> ]
 [ ON ENTER <OnEnterProcedure> | <bBlock> ]
 [ INVISIBLE ]
 [ NOTABSTOP ]

Alternate Syntax:

DEFINE TIMEPICKER <ControlName>
   PARENT <ParentWindowName>
   ROW <nValue>
   COL <nValue>
   WIDTH <nValue>
   HEIGHT <nValue>
   FIELD <FieldName>
   FONTNAME <cValue>
   FONTSIZE <nValue>
   FONTBOLD <lValue>
   FONTITALIC <lValue>
   FONTUNDERLINE <lValue>
   FONTSTRIKEOUT <lValue>
   TOOLTIP <cValue>
   ONGOTFOCUS <ActionProcedure>
   ONLOSTFOCUS <ActionProcedure>
   ONCHANGE <ActionProcedure>
   TABSTOP <lValue>
   HELPID <nValue>
   VISIBLE <lValue>
   VALUE <cValue>
   FORMAT <cTimeFormat>
   SHOWNONE <lValue>
   ONENTER <ActionProcedure>
END TIMEPICKER

Properties:

• Value
• Format
• Enabled
• Visible
• Row
• Col
• Width
• Height
• FontName
• FontSize
• FontBold
• FontItalic
• FontUnderline
• FontStrikeout
• ToolTip
• Name (R)
• Field (D)
• Parent (D)
• ShowNone (D)
• HelpId (D)
• TabStop (D)

D: Available at control definition only R: Read-Only

Events:

• OnGotFocus
• OnChange
• OnLostFocus
• OnEnter

Methods:

• Show
• Hide
• SetFocus
• Release
• Save
• Refresh

Related Functions:

HMG_TimeToValue ( cTime ) --> Return aTimeValue array
HMG_ValueToTime ( aTimeValue , cTimeFormat ) --> Return cTime string
HMG_TimeToTime ( cTime , cNewTimeFormat ) --> Returns cTime string with the time format specified
HMG_IsTimeAMPM ( cTime ) --> Return .T. if cTime contains the substring "am" or "pm"
aTimeValue = { nHour, nMinute, nSecond } --> nHour is always in the 24-hour format

(nHour = 0..23, nMinute = 0..59, nSecond = 0..59)

- cTimeFormat | cNewTimeFormat = _TIMELONG24H | _TIMELONG12H | _TIMESHORT24H | _TIMESHORT12H

- cTime --> eg. "13:37:21" , "01:37:21 pm", "13:37" , "01:37 pm"