DateTime_SetRange Makro (commctrl.h)

Legt die minimalen und maximalen zulässigen Systemzeiten für ein Datums- und Uhrzeitauswahl-Steuerelement (DTP) fest. Sie können dieses Makro verwenden oder die DTM_SETRANGE Nachricht explizit senden.

Syntax

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

Parameter

hdp

Typ: HWND-

Ein Handle für ein DTP-Steuerelement.

gd

Typ: DWORD-

Ein Wert, der angibt, welche Bereichswerte gültig sind. Dieser Wert kann eine Kombination aus folgendem Sein:

Wert	Bedeutung
GDTR_MIN	Das erste Element im SYSTEMTIME Strukturarray ist gültig und wird verwendet, um die zulässige Mindestsystemzeit festzulegen.
GDTR_MAX	Das zweite Element im SYSTEMTIME Strukturarray ist gültig und wird verwendet, um die maximal zulässige Systemzeit festzulegen.

rgst

Typ: LPSYSTEMTIME-

Ein Zeiger auf ein Zweielementarray von SYSTEMTIME- Strukturen. Das erste Element des SYSTEMTIME Arrays enthält die minimale zulässige Zeit. Das zweite Element des SYSTEMTIME Arrays enthält die maximal zulässige Zeit. Es ist nicht erforderlich, ein Arrayelement auszufüllen, das im parameter gd nicht angegeben ist.

Rückgabewert

Typ: BOOL-

Gibt "nonzero" zurück, wenn dies erfolgreich ist, oder 0 andernfalls null.

Bemerkungen

Die Datums- und Uhrzeitauswahl zeigt nur Datums-/Uhrzeitangaben an, die innerhalb des angegebenen Bereichs liegen, sodass der Benutzer ein Datum und eine Uhrzeit auswählt, die außerhalb des Bereichs liegt. Wenn die DateTime_SetSystemtime Nachricht ein Datum und eine Uhrzeit angibt, die außerhalb des Bereichs liegt, tritt ein Fehler auf.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	commctrl.h