bgiSetTimePickerTime

Sets the time in a TimePicker control to the specified hour, minute, and second. Searches gizmoMap for gizmo ID using find(). If found, calls DateTime_GetSystemtime() to retrieve current SYSTEMTIME structure. Modifies st.wHour=hour, st.wMinute=minute, st.wSecond=second. Calls DateTime_SetSystemtime() with GDT_VALID flag to update picker. Returns 1 on success, 0 if gizmo not found.

This function programmatically sets a TimePicker's time. DateTime_GetSystemtime retrieves current SYSTEMTIME (preserving date components if any), then modifies time fields. DateTime_SetSystemtime applies the change with GDT_VALID flag (indicates valid time). The picker's visual display updates immediately. No validation of time values (e.g., hour 25 will be accepted but may cause undefined behavior). Use for setting initial times, restoring saved times, or implementing time navigation. Common values: hour 0-23 (24-hour format), minute 0-59, second 0-59.