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