日付と時刻の選択

[アーティクル]
03/12/2025

このセクションには、日付と時刻の選択コントロールで使用される API 要素に関する情報が含まれています。

概要

話題	内容
日付と時刻の選択コントロールについて	日付と時刻の選択 (DTP) コントロールは、ユーザーと日付と時刻の情報を交換するためのシンプルで直感的なインターフェイスを提供します。
日付と時刻の選択コントロールを使用した	このセクションでは、日付と時刻の選択コントロールを実装するための情報とサンプルコードについて説明します。

マクロ

話題	内容
DateTime_CloseMonthCal	日付と時刻の選択 (DTP) コントロールを閉じます。このマクロを使用するか、DTM_CLOSEMONTHCAL メッセージを明示的に送信します。
DateTime_GetDateTimePickerInfo	指定した日付と時刻の選択 (DTP) コントロールの情報を取得します。
DateTime_GetIdealSize	クリッピングなしでコントロールを表示するために必要なサイズを取得します。このマクロを使用するか、DTM_GETIDEALSIZE メッセージを明示的に送信します。
DateTime_GetMonthCal	日付と時刻の選択ウィンドウ (DTP) の子月カレンダーコントロールへのハンドルを取得します。このマクロを使用することも、DTM_GETMONTHCAL メッセージを明示的に送信することもできます。
DateTime_GetMonthCalColor	日付と時刻の選択 (DTP) コントロール内の月のカレンダーの特定の部分の色を取得します。このマクロを使用することも、DTM_GETMCCOLOR メッセージを明示的に送信することもできます。
DateTime_GetMonthCalFont	日付と時刻の選択 (DTP) コントロールの子月カレンダーコントロールが現在使用しているフォントを取得します。このマクロを使用することも、DTM_GETMCFONT メッセージを明示的に送信することもできます。
DateTime_GetMonthCalStyle	指定した DTP コントロールのスタイルを取得します。このマクロを使用するか、DTM_GETMCSTYLE メッセージを明示的に送信します。
DateTime_GetRange	日付と時刻の選択 (DTP) コントロールの現在の最小および最大許容システム時間を取得します。このマクロを使用することも、DTM_GETRANGE メッセージを明示的に送信することもできます。
DateTime_GetSystemtime	日付と時刻の選択 (DTP) コントロールから現在選択されている時刻を取得し、指定された SYSTEMTIME 構造体に配置します。このマクロを使用することも、DTM_GETSYSTEMTIME メッセージを明示的に送信することもできます。
DateTime_SetFormat	指定した書式指定文字列に基づいて、日付と時刻の選択 (DTP) コントロールの表示を設定します。このマクロを使用することも、DTM_SETFORMAT メッセージを明示的に送信することもできます。
DateTime_SetMonthCalColor	日付と時刻の選択 (DTP) コントロール内の月のカレンダーの特定の部分の色を設定します。このマクロを使用することも、DTM_SETMCCOLOR メッセージを明示的に送信することもできます。
DateTime_SetMonthCalFont	日付と時刻の選択 (DTP) コントロールの子月カレンダーコントロールで使用するフォントを設定します。このマクロを使用することも、DTM_SETMCFONT メッセージを明示的に送信することもできます。
DateTime_SetMonthCalStyle	指定した DTP コントロールのスタイルを設定します。このマクロを使用するか、DTM_SETMCSTYLE メッセージを明示的に送信します。
DateTime_SetRange	日付と時刻の選択 (DTP) コントロールに許容される最小および最大システム時間を設定します。このマクロを使用することも、DTM_SETRANGE メッセージを明示的に送信することもできます。
DateTime_SetSystemtime	日付と時刻の選択 (DTP) コントロールを特定の日付と時刻に設定します。このマクロを使用することも、DTM_SETSYSTEMTIME メッセージを明示的に送信することもできます。

メッセージ

話題	内容
DTM_CLOSEMONTHCAL	DTP コントロールを閉じます。このメッセージを明示的に送信するか、DateTime_CloseMonthCal マクロを使用して送信します。
DTM_GETDATETIMEPICKERINFO	日付と時刻の選択 (DTP) コントロールに関する情報を取得します。
DTM_GETIDEALSIZE	クリッピングなしでコントロールを表示するために必要なサイズを取得します。このメッセージを明示的に送信するか、DateTime_GetIdealSize マクロを使用して送信します。
DTM_GETMCCOLOR	日付と時刻の選択 (DTP) コントロール内の月のカレンダーの特定の部分の色を取得します。このメッセージは明示的に送信することも、DateTime_GetMonthCalColor マクロを使用することもできます。
DTM_GETMCFONT	日付と時刻の選択 (DTP) コントロールの子月カレンダーコントロールが現在使用しているフォントを取得します。このメッセージは明示的に送信することも、DateTime_GetMonthCalFont マクロを使用することもできます。
DTM_GETMCSTYLE	DTP コントロールのスタイルを取得します。このメッセージを明示的に送信するか、DateTime_GetMonthCalStyle マクロを使用して送信します。
DTM_GETMONTHCAL	日付と時刻の選択ウィンドウ (DTP) の子月カレンダーコントロールへのハンドルを取得します。このメッセージは明示的に送信することも、DateTime_GetMonthCal マクロを使用することもできます。
DTM_GETRANGE	日付と時刻の選択 (DTP) コントロールの現在の最小および最大許容システム時間を取得します。このメッセージは明示的に送信することも、DateTime_GetRange マクロを使用することもできます。
DTM_GETSYSTEMTIME	日付と時刻の選択 (DTP) コントロールから現在選択されている時刻を取得し、指定された SYSTEMTIME 構造体に配置します。このメッセージは明示的に送信することも、DateTime_GetSystemtime マクロを使用することもできます。
DTM_SETFORMAT	指定した書式指定文字列に基づいて、日付と時刻の選択 (DTP) コントロールの表示を設定します。このメッセージは明示的に送信することも、DateTime_SetFormat マクロを使用することもできます。
DTM_SETMCCOLOR	日付と時刻の選択 (DTP) コントロール内の月のカレンダーの特定の部分の色を設定します。このメッセージは明示的に送信することも、DateTime_SetMonthCalColor マクロを使用することもできます。
DTM_SETMCFONT	日付と時刻の選択 (DTP) コントロールの子月カレンダーコントロールで使用するフォントを設定します。このメッセージは明示的に送信することも、DateTime_SetMonthCalFont マクロを使用することもできます。
DTM_SETMCSTYLE	DTP コントロールのスタイルを設定します。このメッセージを明示的に送信するか、DateTime_SetMonthCalStyle マクロを使用して送信します。
DTM_SETRANGE	日付と時刻の選択 (DTP) コントロールに許容される最小および最大システム時間を設定します。このメッセージは明示的に送信することも、DateTime_SetRange マクロを使用することもできます。
DTM_SETSYSTEMTIME	日付と時刻の選択 (DTP) コントロールの時刻を設定します。このメッセージは明示的に送信することも、DateTime_SetSystemtime マクロを使用することもできます。

通知

話題	内容
DTN_CLOSEUP	ユーザーがドロップダウン月カレンダーを閉じると、日付と時刻の選択 (DTP) コントロールによって送信されます。月の予定表は、ユーザーが月の予定表から日付を選択するか、予定表を開いている間にドロップダウン矢印をクリックすると閉じられます。
DTN_DATETIMECHANGE	変更が発生するたびに、日付と時刻の選択 (DTP) コントロールによって送信されます。この通知コードは、WM_NOTIFY メッセージの形式で送信されます。
DTN_DROPDOWN	ユーザーがドロップダウン月カレンダーをアクティブ化するときに、日付と時刻の選択 (DTP) コントロールによって送信されます。
DTN_FORMAT	コールバックフィールドに表示するテキストを要求するために、日付と時刻の選択 (DTP) コントロールによって送信されます。この通知コードは、WM_NOTIFY メッセージの形式で送信されます。
DTN_FORMATQUERY	コールバックフィールドに表示される文字列の最大許容サイズを取得するために、日付と時刻の選択 (DTP) コントロールによって送信されます。この通知コードは、WM_NOTIFY メッセージの形式で送信されます。
DTN_USERSTRING	ユーザーがコントロール内の文字列の編集を完了すると、日付と時刻の選択 (DTP) コントロールによって送信されます。この通知コードは、DTS_APPCANPARSE スタイルに設定されている DTP コントロールによってのみ送信されます。このメッセージは、WM_NOTIFY メッセージの形式で送信されます。
DTN_WMKEYDOWN	ユーザーがコールバックフィールドに入力したときに、日付と時刻の選択 (DTP) コントロールによって送信されます。このメッセージは、WM_NOTIFY メッセージの形式で送信されます。
NM_KILLFOCUS (日時)	コントロールが入力フォーカスを失っていることを、日付と時刻の選択コントロールの親ウィンドウに通知します。 NM_KILLFOCUS (日時) は、WM_NOTIFY メッセージの形式で送信されます。
NM_SETFOCUS (日時)	日付と時刻の選択コントロールの親ウィンドウに、コントロールが入力フォーカスを受け取っていることを通知します。 NM_SETFOCUS (日時) は、WM_NOTIFY メッセージの形式で送信されます。

構造

話題	内容
DATETIMEPICKERINFOをする	DTP コントロールに関する情報を格納します。
NMDATETIMECHANGE	日付と時刻の選択 (DTP) コントロールで行われた変更に関する情報が含まれています。この構造体は、DTN_DATETIMECHANGE 通知コードと共に使用されます。
NMDATETIMEFORMATの	日付と時刻の選択 (DTP) コントロール内のコールバックフィールドを定義する書式指定文字列の一部に関する情報を格納します。コールバックフィールドを定義し、コールバックフィールドに表示される文字列を受け取るバッファーを含む部分文字列を保持します。この構造体は、DTN_FORMAT 通知コードと共に使用されます。
NMDATETIMEFORMATQUERYの	日付と時刻の選択 (DTP) コントロールのコールバックフィールドに関する情報が含まれています。これには、コールバックフィールドを定義する部分文字列 (コントロールの書式指定文字列から取得) が含まれています。構造体は、コールバックフィールドに表示されるテキストの最大許容サイズを受け取ります。この構造体は、DTN_FORMATQUERY 通知コードと共に使用されます。
NMDATETIMESTRING	日付と時刻の選択 (DTP) コントロールで行われた編集操作に固有の情報が含まれています。このメッセージは、DTN_USERSTRING 通知コードと共に使用されます。
NMDATETIMEWMKEYDOWNの	DTN_WMKEYDOWN 通知コードの記述と処理に使用される情報を格納します。

定数

話題	内容
日付と時刻の選択コントロールのスタイル	ここに示すウィンドウスタイルは、日付と時刻の選択コントロールに固有です。