DTM_SETRANGE メッセージ

日付と時刻の選択 (DTP) コントロールの許容されるシステムの最小時間と最大時間を設定します。 このメッセージは明示的に送信することも、 DateTime_SetRange マクロを使用することもできます。

パラメーター

wParam

有効な範囲の値を指定する値。 このパラメーターは、次の値と組み合わせて指定できます。

値	説明
GDTR_MIN	SYSTEMTIME 構造体配列の最初の要素は有効であり、許容される最小システム時間を設定するために使用されます。
GDTR_MAX	SYSTEMTIME 構造体配列の 2 番目の要素は有効であり、許容される最大システム時間を設定するために使用されます。

lParam

SYSTEMTIME 構造体の 2 要素配列へのポインター。 SYSTEMTIME 配列の最初の要素には、許容される最小時間が含まれています。 SYSTEMTIME 配列の 2 番目の要素には、許容される最大時間が含まれています。 wParam パラメーターで指定されていない配列要素を入力する必要はありません。

戻り値

成功した場合は 0 以外、それ以外の場合は 0 を返します。

解説

日付と時刻の選択ウィンドウには、指定した範囲内に含まれる日付/時刻のみが表示されるため、ユーザーは範囲外の日付と時刻を選択できなくなります。 DTM_SETSYSTEMTIME メッセージで範囲外の日付と時刻が指定されている場合は、失敗します。

必要条件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー	Commctrl.h