bgiSetDatePickerDate

Sets the date in a DatePicker control to the specified day, month, and year. Searches gizmoMap for gizmo ID using find(). If found, calls DateTime_GetSystemtime() to retrieve current SYSTEMTIME structure. Modifies st.wDay=day, st.wMonth=month, st.wYear=year. Calls DateTime_SetSystemtime() with GDT_VALID flag to update picker. Returns 1 on success, 0 if gizmo not found.

This function programmatically sets a DatePicker's date. DateTime_GetSystemtime retrieves current SYSTEMTIME (preserving time components if any), then modifies date fields. DateTime_SetSystemtime applies the change with GDT_VALID flag (indicates valid date). The picker's visual display updates immediately. No validation of date values (e.g., February 31st will be accepted but may cause undefined behavior). Use for setting initial dates, restoring saved dates, or implementing date navigation. Common values: day 1-31, month 1-12, year 1601-30827 (SYSTEMTIME valid range).