DateTime_SetRange マクロ (commctrl.h)

  • [アーティクル]

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

構文

void DateTime_SetRange(
   hdp,
   gd,
   rgst
);

パラメーター

hdp

種類: HWND

DTP コントロールへのハンドル。

gd

種類: DWORD

有効な範囲の値を指定する 値。 この値には、次の組み合わせを指定できます。

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

rgst

種類: LPSYSTEMTIME

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

戻り値

なし

解説

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

要件

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