MonthCalendar.SelectionEnd プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

MonthCalendar.SelectionEnd プロパティ

選択されている日付範囲の終了日を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property SelectionEnd As
 DateTime

Visual Basic (使用法)

Dim instance As MonthCalendar
Dim value As DateTime

value = instance.SelectionEnd

instance.SelectionEnd = value

public DateTime SelectionEnd { get; set;
 }

C++

public:
property DateTime SelectionEnd {
    DateTime get ();
    void set (DateTime value);
}

/** @property */
public DateTime get_SelectionEnd ()

/** @property */
public void set_SelectionEnd (DateTime value)

JScript

public function get SelectionEnd
 () : DateTime

public function set SelectionEnd
 (value : DateTime)

プロパティ値
選択範囲の最後の日を示す DateTime。

例外

例外の種類	条件
ArgumentOutOfRangeException	日付の値が MinDate より小さい値です。または日付の値が MaxDate 値を超えています。

例外の種類

条件

ArgumentOutOfRangeException

日付の値が MinDate より小さい値です。

または

日付の値が MaxDate 値を超えています。

解説

SelectionEnd プロパティの値を SelectionStart プロパティの現在の値よりも前の日付に設定した場合、SelectionStart は自動的に SelectionEnd と同じ値に設定されます。

MaxSelectionCount プロパティによって指定された日数を超える日付を SelectionEnd に設定した場合、SelectionStart の値は、次のように調整されます。SelectionStart は、選択された日数が MaxSelectionCount に等しくなるように自動的に設定されます。

メモ
MaxSelectionCount は、SelectionStart と SelectionEnd との差ではなく、選択における日数を表します。たとえば、MaxSelectionCount が 7 (既定値) の場合は、SelectionStart と SelectionEnd の間隔が 6 日以下になります。

メモ
visual スタイルが有効にされた MonthCalendar コントロールに対して SelectionRange を設定すると、選択範囲が正確にはコントロール上に描画されません。

使用例

SelectionStart プロパティと SelectionEnd プロパティを使用する方法を次のコード例に示します。この例を実行するには、次のコードを MonthCalendar1 という名前の MonthCalendar コントロールが配置されているフォームに貼り付けて、フォームのコンストラクタまたは Load イベント処理メソッドから ShowAWeeksVacationOneMonthFromToday メソッドを呼び出します。

Visual Basic

' Computes a week one month from today.
Private Sub ShowAWeeksVacationOneMonthFromToday()
     
    Dim today As Date =
 monthCalendar1.TodayDate
    Dim vacationMonth As Integer
 = today.Month + 1
    Dim vacationYear As Integer
 = today.Year
    If (today.Month = 12) Then
        vacationYear += 1
        vacationMonth = 1
    End If

    Me.monthCalendar1.SelectionStart = _
        New Date(vacationYear, vacationMonth,
 today.Day - 1)
    Me.monthCalendar1.SelectionEnd = _
        New Date(vacationYear, vacationMonth,
 today.Day + 6)
End Sub

// Computes a week one month from today.
private void ShowAWeeksVacationOneMonthFromToday()
{
    System.DateTime today = this.MonthCalendar1.TodayDate;
    int vacationMonth = today.Month + 1;
    int vacationYear = today.Year;

    if (today.Month == 12)
    {
        vacationMonth = 1;
        ++vacationYear;
    }

    // Select the week using SelectionStart and SelectionEnd.
    this.MonthCalendar1.SelectionStart = 
        new System.DateTime(today.Year, vacationMonth, today.Day-1);
    this.MonthCalendar1.SelectionEnd = 
        new System.DateTime(today.Year, vacationMonth, today.Day+6);
}

C++

// Computes a week one month from today.
void ShowAWeeksVacationOneMonthFromToday()
{
   System::DateTime today = this->MonthCalendar1->TodayDate;
   int vacationMonth = today.Month + 1;
   int vacationYear = today.Year;

   if ( today.Month == 12 )
   {
      vacationMonth = 1;
      ++vacationYear;
   }
   
   // Select the week using SelectionStart and SelectionEnd.
   this->MonthCalendar1->SelectionStart =
      System::DateTime( today.Year, vacationMonth, today.Day - 1 );
   this->MonthCalendar1->SelectionEnd =
      System::DateTime( today.Year, vacationMonth, today.Day + 6 );
}

// Computes a week one month from today.
private void ShowAWeeksVacationOneMonthFromToday()
{
    System.DateTime today = this.monthCalendar1.get_TodayDate();
    int vacationMonth = 1;
    if (today.get_Month() < 12) {
        vacationMonth = today.get_Month() + 1;
    }
    // Select the week using SelectionStart and SelectionEnd.
    this.monthCalendar1.set_SelectionStart(
        new System.DateTime(today.get_Year(),
        vacationMonth, today.get_Day() - 1));
    this.monthCalendar1.set_SelectionEnd(
        new System.DateTime(today.get_Year(),
        vacationMonth, today.get_Day() + 6));
} //ShowAWeeksVacationOneMonthFromToday