commctrl.h

Macro DateTime_SetRange

Asigna los tiempos de sistema mínimo y máximo permitidos para un control de fecha y hora (DTP). Se puede usar esa macro o bien enviar el mensaje DTM_SETRANGE explícitamente.

Definición

int DateTime_SetRange(
    HWND hdp,
    DWORD gd,
    LPSYSTEMTIME rgst
);

Descripción

hdp
Un manpulador a un control DTP.
gd

Un valor que especifica qué rango de valores son válidos. Este valor puede ser una combinación de los siguientes:

ValorSignificado
GDTR_MINEl primer elemento en el array de estructuras SYSTEMTIME es válido y será usado para asignar el valor mínimo de tiempo de sistema permitido.
GDTR_MAXEl segundo elemento en el array de estructuras SYSTEMTIME es válido y será usado para asignar el valor máximo de tiempo de sistema permitido.
rgst
Un puntero a un array de dos estructuras SYSTEMTIME. El primer elemento del array contiene el valor mínimo de tiempo permitido. El segundo elemento contiene el tiempo máximo permitido. No es necesario asignar un elemento del array si no está especificado en el parámetro de banderas gd.

Valor de retorno

Devuelve un valor distinto de cero si tiene éxito, o cero en caso contrario.

Observaciones

El control de fecha y hora muestra sólo valores que estén dentro del rango especificado, evitando que el usuario selecciones una fecha y hora que esté fuera de ese rango. Si la macro DateTime_SetSystemtime especifica una fecha y hora que estén fuera del rango, fallará.