Creates a time picker control with hour/minute/second spinners.
Takes x (Int), y (Int), width (Int), height (Int), and parentWin (Int).
Returns gizmo ID, or 0 if parent not found.
BGI GUI
Parameters & Returns
Parameters
xInt
yInt
widthInt
heightInt
parentWinInt
Returns
Int
Quick Summary
Creates a time picker control with hour/minute/second spinners.
Takes x (Int), y (Int), width (Int), height (Int), and parentWin (Int).
Returns gizmo ID, or 0 if parent not found.
Technical Exegesis...
Creates a time picker control with hour/minute/second spinners. Searches gizmoMap for parent window ID. Increments gizmoIDCount for unique ID. Uses GetActualParentHWND for scroll panel support. Creates DATETIMEPICK_CLASS control with WS_CHILD | WS_VISIBLE | WS_BORDER | DTS_TIMEFORMAT style. Applies hFont with WM_SETFONT. Gets current time with GetLocalTime(&st), sets picker to current time with DateTime_SetSystemtime(GDT_VALID). Creates CGizmo with GIZMO_TIMEPICKER type, adds to gizmoMap.
Creates a time picker control with hour/minute/second spinners. Searches gizmoMap for parent window ID. Increments gizmoIDCount for unique ID. Uses GetActualParentHWND for scroll panel support. Creates DATETIMEPICK_CLASS control with WS_CHILD | WS_VISIBLE | WS_BORDER | DTS_TIMEFORMAT style. Applies hFont with WM_SETFONT. Gets current time with GetLocalTime(&st), sets picker to current time with DateTime_SetSystemtime(GDT_VALID). Creates CGizmo with GIZMO_TIMEPICKER type, adds to gizmoMap. Returns gizmo ID, or 0 if parent not found.
This function creates a Windows DateTimePicker control in time mode. DTS_TIMEFORMAT displays time format (HH:mm:ss or locale-specific). Control shows text field with up/down spinners for hour, minute, and second components. Initial value is current system time. User can type time or use spinners to adjust. Fires BGI_EVENT_COMMAND_UPDATE with BGI_EVENT_ID_TIMEPICKER when time changes. Use bgiGetTimePickerHour/Minute/Second() to retrieve selected time components. Common pattern: create picker, handle update events, query time with getter functions.