日付と時刻の選択

[アーティクル]
03/04/2024

ここでは、日付と時刻の選択コントロールで使用される API 要素について説明します。

概要

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

マクロ

トピック	内容
DateTime_CloseMonthCal	日付と時刻の選択 (DTP) コントロールを閉じます。このマクロを使用するか、DTM_CLOSEMONTHCAL メッセージを明示的に送信します。
DateTime_GetDateTimePickerInfo	指定された日付と時刻の選択 (DTP) コントロールの情報を取得します。
DateTime_GetIdealSize	クリッピングなしでコントロールを表示するのに必要なサイズを取得します。このマクロを使用するか、DTM_GETIDEALSIZE メッセージを明示的に送信します。
DateTime_GetMonthCal	日付と時刻の選択 (DTP) の子である月間予定表コントロールのハンドルを取得します。このマクロを使用するか、DTM_GETMONTHCAL メッセージを明示的に送信します。
DateTime_GetMonthCalColor	日付と時刻の選択 (DTP) コントロール内の 1 か月カレンダーの特定の部分の色を取得します。このマクロを使用するか、DTM_GETMCCOLOR メッセージを明示的に送信します。
DateTime_GetMonthCalFont	日付と時刻の選択 (DTP) コントロールの子である 1 か月カレンダーコントロールで現在使用されているフォントを取得します。このマクロを使用するか、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) コントロール内の 1 か月カレンダーの特定の部分の色を設定します。このマクロを使用するか、DTM_SETMCCOLOR メッセージを明示的に送信します。
DateTime_SetMonthCalFont	日付と時刻の選択 (DTP) コントロールの子である 1 か月カレンダーコントロールで使用されるフォントを設定します。このマクロを使用するか、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) コントロール内の 1 か月カレンダーの特定の部分の色を取得します。このメッセージを明示的に送信するか、DateTime_GetMonthCalColor マクロを使用します。
DTM_GETMCFONT	日付と時刻の選択 (DTP) コントロールの子である 1 か月カレンダーコントロールで現在使用されているフォントを取得します。このメッセージを明示的に送信するか、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) コントロール内の 1 か月カレンダーの特定の部分の色を設定します。このメッセージを明示的に送信するか、DateTime_SetMonthCalColor マクロを使用します。
DTM_SETMCFONT	日付と時刻の選択 (DTP) コントロールの子である 1 か月カレンダーコントロールで使用されるフォントを設定します。このメッセージを明示的に送信するか、DateTime_SetMonthCalFont マクロを使用します。
DTM_SETMCSTYLE	DTP コントロールのスタイルを設定します。このメッセージを明示的に送信するか、DateTime_SetMonthCalStyle マクロを使用します。
DTM_SETRANGE	日付と時刻の選択 (DTP) コントロールで許容されるシステム時刻の最小値と最大値を設定します。このメッセージを明示的に送信するか、DateTime_SetRange マクロを使用します。
DTM_SETSYSTEMTIME	日付と時刻の選択 (DTP) コントロールの時刻を設定します。このメッセージを明示的に送信するか、DateTime_SetSystemtime マクロを使用します。

通知

トピック	内容
DTN_CLOSEUP	ユーザーがドロップダウンの 1 か月カレンダーを閉じたときに、日付と時刻の選択 (DTP) コントロールによって送信されます。ユーザーが 1 か月カレンダーから日付を選択するか、カレンダーを開いている間にドロップダウン矢印をクリックすると、1 か月カレンダーが閉じられます。
DTN_DATETIMECHANGE	変更が発生するたびに、日付と時刻の選択 (DTP) コントロールによって送信されます。この通知コードは、WM_NOTIFY メッセージの形式で送信されます。
DTN_DROPDOWN	ユーザーがドロップダウンの 1 か月カレンダーをアクティブ化したときに、日付と時刻の選択 (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 通知コードの記述と処理に使用される情報が格納されています。

定数

トピック	内容
日付と時刻の選択コントロールスタイル	一覧に示したウィンドウスタイルは、日付と時刻の選択コントロールに固有のものです。