DateTime_GetRange macro

Gets the current minimum and maximum allowable system times for a date and time picker (DTP) control. You can use this macro, or send the DTM_GETRANGE message explicitly.

Syntax


DWORD DateTime_GetRange(
   HWND         hwndDT,
   LPSYSTEMTIME lpSysTimeArray
);

Parameters

hwndDT

Type: HWND

A handle to a DTP control.

lpSysTimeArray

Type: LPSYSTEMTIME

A pointer to a two-element array of SYSTEMTIME structures.

Return value

Returns a DWORD value that is a combination of GDTR_MIN or GDTR_MAX. The first element of the SYSTEMTIME array contains the minimum allowable time. The second element of the SYSTEMTIME array contains the maximum allowable time.

Remarks

The date and time picker displays only dates/times that fall within the specified range, preventing the user from selecting a date and time that falls outside the range. If the DateTime_SetSystemtime message specifies a date and time that falls outside the range, it will fail.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Commctrl.h

 

 

Show: