月カレンダー コントロール
このセクションでは、月のカレンダー コントロールで使用されるプログラミング要素について説明します。
概要
| 話題 | 内容 |
|---|---|
| 月カレンダー コントロールについて | 月のカレンダー コントロールは、カレンダーのようなユーザー インターフェイスを実装します。 |
| 月の予定表コントロールを使用する | このセクションでは、月のカレンダー コントロールのプログラミングに関する情報を提供します。 |
マクロ
| 話題 | 内容 |
|---|---|
| MonthCal_GetCalendarBorder | 月のカレンダー コントロールの境界線のサイズ (ピクセル単位) を取得します。 このマクロを使用することも、MCM_GETCALENDARBORDER メッセージを明示的に送信することもできます。 |
| MonthCal_GetCalendarCount | 予定表コントロールに現在表示されている予定表の数を取得します。 このマクロを使用することも、MCM_GETCALENDARCOUNT メッセージを明示的に送信することもできます。 |
| MonthCal_GetCalendarGridInfo | 予定表グリッドに関する情報を取得します。 |
| MonthCal_GetCALID | 指定された予定表コントロールの現在の予定表 ID を取得します。 このマクロを使用することも、MCM_GETCALID メッセージを明示的に送信することもできます。 |
| MonthCal_GetColor | 月のカレンダー コントロールの特定の部分の色を取得します。 このマクロを使用することも、MCM_GETCOLOR メッセージを明示的に送信することもできます。 |
| MonthCal_GetCurrentView | 月の予定表コントロールのビューを取得します。 このマクロを使用することも、MCM_GETCURRENTVIEW メッセージを明示的に送信することもできます。 |
| MonthCal_GetCurSel | 現在選択されている日付を取得します。 このマクロを使用することも、MCM_GETCURSEL メッセージを明示的に送信することもできます。 |
| MonthCal_GetFirstDayOfWeek | 月の予定表コントロールの週の最初の日を取得します。 このマクロを使用することも、MCM_GETFIRSTDAYOFWEEK メッセージを明示的に送信することもできます。 |
| MonthCal_GetMaxSelCount | 月の予定表コントロールで選択できる最大日付範囲を取得します。 このマクロを使用することも、MCM_GETMAXSELCOUNT メッセージを明示的に送信することもできます。 |
| MonthCal_GetMaxTodayWidth | 月の予定表コントロールの "today" 文字列の最大幅を取得します。 これには、ラベル テキストと日付テキストが含まれます。 このマクロを使用することも、MCM_GETMAXTODAYWIDTH メッセージを明示的に送信することもできます。 |
| MonthCal_GetMinReqRect | 1 か月のカレンダー コントロールで完全な月を表示するために必要な最小サイズを取得します。 サイズ情報は、RECT 構造体の形式で表示されます。 このマクロを使用することも、MCM_GETMINREQRECT メッセージを明示的に送信することもできます。 |
| MonthCal_GetMonthDelta | 月の予定表コントロールのスクロール速度を取得します。 スクロール レートは、ユーザーがスクロール ボタンをクリックしたときにコントロールが表示を移動する月数です。 このマクロを使用することも、MCM_GETMONTHDELTA メッセージを明示的に送信することもできます。 |
| MonthCal_GetMonthRange | 月のカレンダー コントロールの表示の上限と下限を表す日付情報を取得します (SYSTEMTIME構造体使用)。 このマクロを使用することも、MCM_GETMONTHRANGE メッセージを明示的に送信することもできます。 |
| MonthCal_GetRange | 月の予定表コントロールに設定されている許容される最小および最大の日付を取得します。 このマクロを使用することも、MCM_GETRANGE メッセージを明示的に送信することもできます。 |
| MonthCal_GetSelRange | ユーザーが現在選択している日付範囲の上限と下限を表す日付情報を取得します。 このマクロを使用することも、MCM_GETSELRANGE メッセージを明示的に送信することもできます。 |
| MonthCal_GetToday | 月の予定表コントロールの "today" として指定された日付の日付情報を取得します。 このマクロを使用することも、MCM_GETTODAY メッセージを明示的に送信することもできます。 |
| MonthCal_GetUnicodeFormat | コントロールの Unicode 文字形式フラグを取得します。 このマクロを使用することも、MCM_GETUNICODEFORMAT メッセージを明示的に送信することもできます。 |
| MonthCal_HitTest | 画面上の特定のポイントにある月のカレンダー コントロールの部分を決定します。 このマクロを使用することも、MCM_HITTEST メッセージを明示的に送信することもできます。 |
| MonthCal_SetCalendarBorder | 月のカレンダー コントロールの境界線のサイズをピクセル単位で設定します。 このマクロを使用することも、MCM_SETCALENDARBORDER メッセージを明示的に送信することもできます。 |
| MonthCal_SetCALID | 指定した予定表コントロールの予定表 ID を設定します。 このマクロを使用することも、MCM_SETCALID メッセージを明示的に送信することもできます。 |
| MonthCal_SetColor | 月のカレンダー コントロールの特定の部分の色を設定します。 このマクロを使用することも、MCM_SETCOLOR メッセージを明示的に送信することもできます。 |
| MonthCal_SetCurrentView | 月の予定表コントロールのビューを設定します。 このマクロを使用することも、MCM_SETCURRENTVIEW メッセージを明示的に送信することもできます。 |
| MonthCal_SetCurSel | 月の予定表コントロールに現在選択されている日付を設定します。 指定した日付が表示されていない場合、コントロールは表示を更新して表示します。 このマクロを使用することも、MCM_SETCURSEL メッセージを明示的に送信することもできます。 |
| MonthCal_SetDayState | 1 か月の予定表コントロール内で現在表示されているすべての月の日付の状態を設定します。 このマクロを使用することも、MCM_SETDAYSTATE メッセージを明示的に送信することもできます。 |
| MonthCal_SetFirstDayOfWeek | 月の予定表コントロールの週の最初の日を設定します。 このマクロを使用することも、MCM_SETFIRSTDAYOFWEEK メッセージを明示的に送信することもできます。 |
| MonthCal_SetMaxSelCount | 月の予定表コントロールで選択できる最大日数を設定します。 このマクロを使用することも、MCM_SETMAXSELCOUNT メッセージを明示的に送信することもできます。 |
| MonthCal_SetMonthDelta | 月の予定表コントロールのスクロール速度を設定します。 スクロール レートは、ユーザーがスクロール ボタンをクリックしたときにコントロールが表示を移動する月数です。 このマクロを使用することも、MCM_SETMONTHDELTA メッセージを明示的に送信することもできます。 |
| MonthCal_SetRange | 1 か月の予定表コントロールに許容される最小および最大の日付を設定します。 このマクロを使用することも、MCM_SETRANGE メッセージを明示的に送信することもできます。 |
| MonthCal_SetSelRange | 月の予定表コントロールの選択を特定の日付範囲に設定します。 このマクロを使用することも、MCM_SETSELRANGE メッセージを明示的に送信することもできます。 |
| MonthCal_SetToday | 月の予定表コントロールの "今日" の選択を設定します。 このマクロを使用することも、MCM_SETTODAY メッセージを明示的に送信することもできます。 |
| MonthCal_SetUnicodeFormat | コントロールの Unicode 文字書式フラグを設定します。 このメッセージを使用すると、コントロールを再作成する必要なく、実行時にコントロールで使用される文字セットを変更できます。 このマクロを使用することも、MCM_SETUNICODEFORMAT メッセージを明示的に送信することもできます。 |
| MonthCal_SizeRectToMin | 指定した四角形に収まるカレンダーの数を計算し、そのカレンダーの数に合わせて四角形に必要な最小サイズを返します。 このマクロを使用することも、MCM_SIZERECTTOMIN メッセージを明示的に送信することもできます。 |
メッセージ
| 話題 | 内容 |
|---|---|
| MCM_GETCALENDARBORDER | 境界線のサイズをピクセル単位で取得します。 このメッセージは、明示的に送信することも、MonthCal_GetCurrentView マクロを使用して送信することもできます。 |
| MCM_GETCALENDARCOUNT | 予定表コントロールに現在表示されている予定表の数を取得します。 このメッセージは、明示的に送信することも、MonthCal_GetCalendarCount マクロを使用して送信することもできます。 |
| MCM_GETCALENDARGRIDINFO | 予定表グリッドに関する情報を取得します。 |
| MCM_GETCALID | 指定された予定表コントロールの予定表 ID を取得します。 このメッセージは、明示的に送信することも、MonthCal_GetCALID マクロを使用して送信することもできます。 |
| MCM_GETCOLOR | 月のカレンダー コントロールの特定の部分の色を取得します。 このメッセージは、明示的に送信することも、MonthCal_GetColor マクロを使用して送信することもできます。 |
| MCM_GETCURRENTVIEW | 予定表の現在のビューを取得します。 このメッセージは、明示的に送信することも、MonthCal_GetCurrentView マクロを使用して送信することもできます。 |
| MCM_GETCURSEL | 現在選択されている日付を取得します。 このメッセージは、明示的に送信することも、MonthCal_GetCurSel マクロを使用して送信することもできます。 |
| MCM_GETFIRSTDAYOFWEEK | 月の予定表コントロールの週の最初の日を取得します。 このメッセージは、明示的に送信することも、MonthCal_GetFirstDayOfWeek マクロを使用して送信することもできます。 |
| MCM_GETMAXSELCOUNT | 月の予定表コントロールで選択できる最大日付範囲を取得します。 このメッセージは、明示的に送信することも、MonthCal_GetMaxSelCount マクロを使用して送信することもできます。 |
| MCM_GETMAXTODAYWIDTH | 月の予定表コントロールの "today" 文字列の最大幅を取得します。 これには、ラベル テキストと日付テキストが含まれます。 このメッセージは、明示的に送信することも、MonthCal_GetMaxTodayWidth マクロを使用して送信することもできます。 |
| MCM_GETMINREQRECT | 1 か月のカレンダー コントロールで完全な月を表示するために必要な最小サイズを取得します。 このメッセージは、明示的に送信することも、MonthCal_GetMinReqRect マクロを使用して送信することもできます。 |
| MCM_GETMONTHDELTA | 月の予定表コントロールのスクロール速度を取得します。 スクロール レートは、ユーザーがスクロール ボタンをクリックしたときにコントロールが表示を移動する月数です。 このメッセージは、明示的に送信することも、MonthCal_GetMonthDelta マクロを使用して送信することもできます。 |
| MCM_GETMONTHRANGE | 月のカレンダー コントロールの表示の上限と下限を表す日付情報を取得します (SYSTEMTIME構造体使用)。 このメッセージは、明示的に送信することも、MonthCal_GetMonthRange マクロを使用して送信することもできます。 |
| MCM_GETRANGE | 月の予定表コントロールに設定されている許容される最小および最大の日付を取得します。 このメッセージは、明示的に送信することも、MonthCal_GetRange マクロを使用して送信することもできます。 |
| MCM_GETSELRANGE | ユーザーが現在選択している日付範囲の上限と下限を表す日付情報を取得します。 このメッセージは、明示的に送信することも、MonthCal_GetSelRange マクロを使用して送信することもできます。 |
| MCM_GETTODAY | 月の予定表コントロールの "today" として指定された日付の日付情報を取得します。 このメッセージは、明示的に送信することも、MonthCal_GetToday マクロを使用して送信することもできます。 |
| MCM_GETUNICODEFORMAT | コントロールの Unicode 文字形式フラグを取得します。 このメッセージは明示的に送信することも、MonthCal_GetUnicodeFormat マクロを使用することもできます。 |
| MCM_HITTEST | 画面上の特定のポイントにある月のカレンダー コントロールの部分を決定します。 このメッセージは、明示的に送信することも、MonthCal_HitTest マクロを使用して送信することもできます。 |
| MCM_SETCALENDARBORDER | 境界線のサイズをピクセル単位で設定します。 このメッセージは、明示的に送信することも、MonthCal_SetCurrentView マクロを使用して送信することもできます。 |
| MCM_SETCALID | 指定した予定表コントロールの予定表 ID を設定します。 このメッセージは、明示的に送信することも、MonthCal_SetCALID マクロを使用して送信することもできます。 |
| MCM_SETCOLOR | 月のカレンダー コントロールの特定の部分の色を設定します。 このメッセージは、明示的に送信することも、MonthCal_SetColor マクロを使用して送信することもできます。 |
| MCM_SETCURRENTVIEW | 予定表の現在のビューを設定します。 このメッセージは、明示的に送信することも、MonthCal_SetCurrentView マクロを使用して送信することもできます。 |
| MCM_SETCURSEL | 月の予定表コントロールに現在選択されている日付を設定します。 指定した日付が表示されていない場合、コントロールは表示を更新して表示します。 このメッセージは、明示的に送信することも、MonthCal_SetCurSel マクロを使用して送信することもできます。 |
| MCM_SETDAYSTATE | 1 か月の予定表コントロール内で現在表示されているすべての月の日付の状態を設定します。 このメッセージは、明示的に送信することも、MonthCal_SetDayState マクロを使用して送信することもできます。 |
| MCM_SETFIRSTDAYOFWEEK | 月の予定表コントロールの週の最初の日を設定します。 このメッセージは、明示的に送信することも、MonthCal_SetFirstDayOfWeek マクロを使用して送信することもできます。 |
| MCM_SETMAXSELCOUNT | 月の予定表コントロールで選択できる最大日数を設定します。 このメッセージは、明示的に送信することも、MonthCal_SetMaxSelCount マクロを使用して送信することもできます。 |
| MCM_SETMONTHDELTA | 月の予定表コントロールのスクロール速度を設定します。 スクロール レートは、ユーザーがスクロール ボタンをクリックしたときにコントロールが表示を移動する月数です。 このメッセージは、明示的に送信することも、MonthCal_SetMonthDelta マクロを使用して送信することもできます。 |
| MCM_SETRANGE | 1 か月の予定表コントロールに許容される最小および最大の日付を設定します。 このメッセージは、明示的に送信することも、MonthCal_SetRange マクロを使用して送信することもできます。 |
| MCM_SETSELRANGE | 月の予定表コントロールの選択を特定の日付範囲に設定します。 このメッセージは、明示的に送信することも、MonthCal_SetSelRange マクロを使用して送信することもできます。 |
| MCM_SETTODAY | 月の予定表コントロールの "今日" の選択を設定します。 このメッセージは、明示的に送信することも、MonthCal_SetToday マクロを使用して送信することもできます。 |
| MCM_SETUNICODEFORMAT | コントロールの Unicode 文字書式フラグを設定します。 このメッセージを使用すると、コントロールを再作成する必要なく、実行時にコントロールで使用される文字セットを変更できます。 このメッセージは明示的に送信することも、MonthCal_SetUnicodeFormat マクロを使用することもできます。 |
| MCM_SIZERECTTOMIN | 指定した四角形に収まるカレンダーの数を計算し、そのカレンダーの数に合わせて四角形に必要な最小サイズを返します。 このメッセージは、明示的に送信することも、MonthCal_SizeRectToMin マクロを使用して送信することもできます。 |
通知
| 話題 | 内容 |
|---|---|
| MCN_GETDAYSTATE | 月の予定表コントロールによって送信され、個々の日の表示方法に関する情報を要求します。 この通知コードは、MCS_DAYSTATE スタイルを使用する月の予定表コントロールによってのみ送信され、WM_NOTIFY メッセージの形式で送信されます。 |
| MCN_SELCHANGE | 現在選択されている日付または日付の範囲が変更されたときに、月のカレンダー コントロールによって送信されます。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| MCN_SELECT | ユーザーが月の予定表コントロール内で明示的な日付の選択を行うときに、月の予定表コントロールによって送信されます。 この通知は、WM_NOTIFY メッセージの形式で送信されます。 |
| MCN_VIEWCHANGE | 現在のビューが変更されたときに、月の予定表コントロールによって送信されます。 この通知コードは、WM_NOTIFY メッセージの形式で送信されます。 |
| NM_RELEASEDCAPTURE (月単位) | 月単位のコントロールの親ウィンドウに、コントロールがマウス キャプチャを解放していることを通知します。 この通知は、WM_NOTIFY メッセージの形式で送信されます。 |
構造
| 話題 | 内容 |
|---|---|
| MCGRIDINFOの | 予定表コントロールの一部に関する情報を格納します。 |
| MCHITTESTINFOの | 1 か月のカレンダー コントロールのヒット テスト ポイントに固有の情報を格納します。 この構造体は、MCM_HITTEST メッセージおよび対応する MonthCal_HitTest マクロと共に使用されます。 |
| NMDAYSTATE |
MCN_GETDAYSTATE 通知コードを処理するために必要な情報を格納します。 この構造体のすべてのメンバーは、prgDayStateを除く入力用です。これは、MCN_GETDAYSTATEの処理時に受信側アプリケーションが設定する必要があります。 |
| NMSELCHANGEをする |
MCN_SELCHANGE 通知コードを処理するために必要な情報を格納します。 |
| NMVIEWCHANGEをする |
MCN_VIEWCHANGE 通知コードを処理するために必要な情報を格納します。 |
定数
| 話題 | 内容 |
|---|---|
| 月カレンダー コントロールのスタイル | 月のカレンダー コントロールを作成する場合は、次のスタイル定数が使用されます。 |
データ型
| 話題 | 内容 |
|---|---|
| MONTHDAYSTATE |
MONTHDAYSTATE データ型は、1 か月の毎日の状態を保持するビットフィールドです。 |