macro DateTime_SetRange (commctrl.h)

Définit les heures système minimales et maximales autorisées pour un contrôle de sélecteur de date et d’heure (DTP). Vous pouvez utiliser cette macro ou envoyer explicitement le message DTM_SETRANGE.

Syntaxe

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

Paramètres

hdp

Type : HWND

Handle vers un contrôle DTP.

gd

Type : DWORD

Valeur qui spécifie les valeurs de plage valides. Cette valeur peut être une combinaison des éléments suivants :

Valeur Signification
GDTR_MIN
Le premier élément du tableau de structure SYSTEMTIME est valide et sera utilisé pour définir l’heure système minimale autorisée.
GDTR_MAX
Le deuxième élément du tableau de structure SYSTEMTIME est valide et sera utilisé pour définir le temps système maximal autorisé.

rgst

Type : LPSYSTEMTIME

Pointeur vers un tableau à deux éléments de structures SYSTEMTIME. Le premier élément du tableau SYSTEMTIME contient le temps minimal autorisé. Le deuxième élément du tableau SYSTEMTIME contient le temps maximal autorisé. Il n’est pas nécessaire de remplir un élément de tableau qui n’est pas spécifié dans le paramètre gd.

Valeur de retour

Type : BOOL

Retourne une valeur différente de zéro si elle réussit ou zéro dans le cas contraire.

Remarques

Le sélecteur de date et d’heure affiche uniquement les dates/heures comprises dans la plage spécifiée, ce qui empêche l’utilisateur de sélectionner une date et une heure qui se trouvent en dehors de la plage. Si le message DateTime_SetSystemtime spécifie une date et une heure qui se situent en dehors de la plage, elle échoue.

Exigences

Exigence Valeur
client minimum pris en charge Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2003 [applications de bureau uniquement]
plateforme cible Windows
d’en-tête commctrl.h