macro DateTime_SetRange (commctrl.h)

  • Articolo

Imposta le ore di sistema minime e massime consentite per un controllo selezione data e ora (DTP). È possibile utilizzare questa macro o inviare il messaggio di DTM_SETRANGE in modo esplicito.

Sintassi

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

Parametri

hdp

Tipo: HWND

Handle per un controllo DTP.

gd

Tipo: DWORD

Valore che specifica i valori di intervallo validi. Questo valore può essere una combinazione di quanto segue:

Valore Significato
GDTR_MIN
 Il primo elemento nella matrice di struttura SYSTEMTIME è valido e verrà usato per impostare il tempo di sistema minimo consentito.
GDTR_MAX
 Il secondo elemento nella matrice di struttura SYSTEMTIME è valido e verrà usato per impostare il tempo di sistema massimo consentito.

rgst

Tipo: LPSYSTEMTIME

Puntatore a una matrice a due elementi di strutture SYSTEMTIME. Il primo elemento della matrice SYSTEMTIME contiene il tempo minimo consentito. Il secondo elemento della matrice SYSTEMTIME contiene il tempo massimo consentito. Non è necessario riempire un elemento di matrice non specificato nel parametro gd.

Valore restituito

Tipo: BOOL

Restituisce un valore diverso da zero se ha esito positivo o zero in caso contrario.

Osservazioni

La selezione data e ora visualizza solo date/ore che rientrano nell'intervallo specificato, impedendo all'utente di selezionare una data e un'ora che non rientra nell'intervallo. Se il messaggio DateTime_SetSystemtime specifica una data e un'ora che non rientra nell'intervallo, l'operazione avrà esito negativo.

Fabbisogno

Requisito Valore
client minimo supportato Windows Vista [solo app desktop]
server minimo supportato Windows Server 2003 [solo app desktop]
piattaforma di destinazione Finestre
intestazione commctrl.h