MonthCalendar コントロールの概要 (Windows フォーム)

  • [アーティクル]

Windows フォームの MonthCalendar コントロールは、ユーザーが日付情報を表示して設定するための直感的なグラフィカル インターフェイスを提示します。 このコントロールには、カレンダーが表示されます。カレンダーは、月の日付を含んだグリッドで表示され、選択した日付範囲は強調表示されます。 月のキャプションの両側にある矢印ボタンをクリックすることで、別の月を選択できます。 これに似た DateTimePicker コントロールとは異なり、このコントロールでは複数の日付を選択できます。 DateTimePicker コントロールについて詳しくは、「DateTimePicker コントロール」をご覧ください。

MonthCalendar コントロールの構成

MonthCalendar コントロールの外観は、高度な構成が可能です。 既定では、今日の日付は丸で囲まれて表示され、グリッドの下部にも示されます。 この機能を変更するには、ShowToday プロパティと ShowTodayCircle プロパティを false に設定します。 また、ShowWeekNumbers プロパティを true に設定することで、週番号をカレンダーに追加することもできます。 CalendarDimensions プロパティを設定すると、複数の月を水平方向や垂直方向に表示できます。 既定では、日曜日は週の最初の曜日として表示されますが、FirstDayOfWeek プロパティを使用すれば任意の日を指定できます。

また、BoldedDates、AnnuallyBoldedDates、および MonthlyBoldedDates の各プロパティに DateTime オブジェクトを追加することで、特定の日付を 1 回のみ、年単位、または月単位で太字で表示するように設定することもできます。 詳細については、「方法: Windows フォームの MonthCalendar コントロールを使用して特定の日付を太字で表示する」を参照してください。

MonthCalendar コントロールの主要プロパティは SelectionRange です。これは、コントロールで選択された日付の範囲です。 SelectionRange の値は、MaxSelectionCount プロパティで設定された最大日数を超えることはできません。 ユーザーがいつからいつまでの日付を選択できるかは、MaxDate プロパティと MinDate プロパティによって決まります。

関連項目