MonthCalendar.SelectionRange プロパティ

定義

月間予定表コントロールの選択されている日付範囲を取得または設定します。Gets or sets the selected range of dates for a month calendar control.

public:
 property System::Windows::Forms::SelectionRange ^ SelectionRange { System::Windows::Forms::SelectionRange ^ get(); void set(System::Windows::Forms::SelectionRange ^ value); };
[System.ComponentModel.Bindable(true)]
public System.Windows.Forms.SelectionRange SelectionRange { get; set; }
public System.Windows.Forms.SelectionRange SelectionRange { get; set; }
member this.SelectionRange : System.Windows.Forms.SelectionRange with get, set
Public Property SelectionRange As SelectionRange

プロパティ値

選択範囲の開始日と終了日による SelectionRangeA SelectionRange with the start and end dates of the selected range.

属性

例外

割り当てられている StartSelectionRange 値が、月間予定表コントロールで使用できる日付の最小値未満です。The Start value of the assigned SelectionRange is less than the minimum date allowable for a month calendar control.

または-or- 割り当てられている StartSelectionRange 値が、月間予定表コントロールで使用できる日付の最大値を超えています。The Start value of the assigned SelectionRange is greater than the maximum allowable date for a month calendar control.

または-or- 割り当てられている EndSelectionRange 値が、月間予定表コントロールで使用できる日付の最小値未満です。The End value of the assigned SelectionRange is less than the minimum date allowable for a month calendar control.

または-or- 割り当てられている EndSelectionRange 値が、月間予定表コントロールで使用できる日付の最大値を超えています。The End value of the assigned SelectionRange is greater than the maximum allowable date for a month calendar control.

注釈

このプロパティの設定は、SetSelectionRange メソッドを使用するのと機能的には同じです。Setting this property is functionally equivalent to using the SetSelectionRange method. SelectionStart または SelectionEnd のいずれかのプロパティを設定して、開始日と終了日を個別に設定できます。You can set the start and end dates separately by setting either the SelectionStart or SelectionEnd properties. SelectionRange プロパティの SelectionRange.Start または SelectionRange.End プロパティ値を設定することによって、開始日と終了日を変更することはできません。You cannot change the start and end dates by setting the SelectionRange.Start or SelectionRange.End property values of the SelectionRange property. SelectionStartSelectionEnd、または SetSelectionRangeを使用する必要があります。You should use SelectionStart, SelectionEnd, or SetSelectionRange.

SelectionRangeStart プロパティ値が End プロパティ値よりも大きい場合、日付は交換されます。End プロパティ値が開始日になり、Start プロパティ値が終了日になります。If the Start property value of the SelectionRange is greater than its End property value, the dates are swapped; the End property value becomes the starting date, and Start property value becomes the end date.

注意

範囲を選択したときにナビゲーションボタンを使用して予定表の表示をスクロールすると、予期しない結果が発生することがあります (たとえば、日付範囲が保持されません)。Scrolling through the calendar display with the navigation buttons when a range is selected can cause unexpected results (for example, the date range is not preserved). 1か月が 04/01/2001 ~ 04/10/2001 の範囲で表示されている場合は、カレンダーを3月にスクロールすると、選択した範囲が03/01/2001 から03/10/2001 に変わります。If you have a single month displayed with a range of 04/01/2001 to 04/10/2001, scrolling the calendar to March changes the selected range as follows: 03/01/2001 to 03/10/2001. 複数の月が表示されている場合 (たとえば、04/01/2001 年3月と4月の範囲で、~ 04/10/2001 が選択されている場合)、カレンダーを1月にスクロールして、2月目に選択した範囲を次のように変更します: 01/01/2001 から01/10/2001。If you have multiple months displayed, such as March and April with a selected range of 04/01/2001 to 04/10/2001, scrolling the calendar back to January and February changes the selected range as follows: 01/01/2001 to 01/10/2001.

注意

視覚スタイルが有効になっている MonthCalendar コントロールの SelectionRange を設定すると、コントロールで選択範囲が正しく描画されません。Setting the SelectionRange for a MonthCalendar control that has visual styles enabled will result in the selection range not painting correctly on the control.

適用対象

こちらもご覧ください