リサイズはクリックかドラッグ

日付を選択する

このトピックでは、日付の選択モードを設定する方法と、選択された日付を取得する方法について解説します。

選択モードの指定

GcDropDownCalendar コントロールには、日付の選択方法として、1つの日付だけを選択する単一選択と、複数の日付を選択する複数選択の2種類があります。これらの選択方法は、SelectionMode プロパティで指定します。

設定値説明
CalendarSelectionMode.SingleDate単一の日付を選択できます。
CalendarSelectionMode.SingleRange単一の日付範囲を選択できます。
CalendarSelectionMode.MultipleRange複数の日付範囲を選択できます。
CalendarSelectionMode.None日付を選択することはできません。

また、選択可能な日付の種類は、AllowSelection プロパティで設定します。

設定値説明
AllowSelection.AnyDayすべての日付が選択できます。
AllowSelection.Workday営業日のみ選択できます。
AllowSelection.Holiday休日および休業日のみ選択できます。

日付選択の操作は、目的の日付をマウスでクリックするか、または矢印キーでフォーカス枠を移動し、［Space］または［Enter］キーを押して行います。また、SelectionMode プロパティを CalendarSelectionMode.SingleRange あるいは CalendarSelectionMode.MultipleRange に設定した場合は、[Ctrl] キーや [Shif]t キーを使って日付範囲を選択できます。

選択された日付の取得

マウスやキーボードの操作で選択された日付は、選択モードの違いによって SelectedDate プロパティあるいは SelectedDates プロパティを使い分けて取得します。

SelectedDate プロパティは、単一の日付を選択した場合はその日付を、複数の日付を選択した場合はそれらの日付の中で最も小さい日付を返します。また、SelectedDates プロパティが返すコレクションには、選択された日付が格納されます。

コードによる日付選択

SelectionMode プロパティが CalendarSelectionMode.SingleDate の場合は SelectedDate プロパティを、CalendarSelectionMode.SingleRange あるいは CalendarSelectionMode.MultipleRange の場合は SelectedDates プロパティを使用して、特定の日付あるいは日付範囲をコード上から選択状態にすることができます。

注意 メモ 注意

SelectionMode プロパティが CalendarSelectionMode.SingleDate の場合、SelectedDates プロパティを使用して日付を選択することはできません。

また、選択不可としてマークされている日付を SelectedDate プロパティもしくは SelectedDates プロパティを使用して選択することはできません。

以下のサンプルコードは、単一の日付範囲選択を可能にして、2010/09/15～2010/09/18 までを選択範囲に含めます。

コピー
GcDropDownCalendar1.SelectionMode = CalendarSelectionMode.SingleRange;
GcDropDownCalendar1.SelectedDates.AddRange(new DateTime(2010, 9, 15), new DateTime(2010, 9, 18));
日付選択時のイベント

直前に選択されていた日付とは異なる日付が選択されたときには、単一選択モードと複数選択モードの両方で SelectedDatesChanged イベントが発生します。また、フォーカス枠を移動したときには、FocusedDateChanged イベントが発生します。

また、カレンダー上の日付をクリックしたときには ClickDate イベントが、ダブルクリックした場合は DoubleClickDate イベントが発生します。

サンプルコード

以下のサンプルコードは、複数選択モードで選択された日付をリストボックスに表示します。

コピー
private void GcDropDownCalendar1_SelectedDatesChanged(object sender, SelectionChangedEventArgs e)
{
    // リストボックスをクリアします。 
    ListBox1.Items.Clear();

    // 選択された日付をリストボックスに表示します。
    foreach(DateTime aDay in GcDropDownCalendar1.SelectedDates)
        ListBox1.Items.Add(aDay.ToShortDateString());
}
参照