Export (0) Print
Expand All

SelectionRange Class

Represents a date selection range in a month calendar control.

For a list of all members of this type, see SelectionRange Members.

System.Object
   System.Windows.Forms.SelectionRange

[Visual Basic]
NotInheritable Public Class SelectionRange
[C#]
public sealed class SelectionRange
[C++]
public __gc __sealed class SelectionRange
[JScript]
public class SelectionRange

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Remarks

The SelectionRange is the date or dates selected and highlighted on the MonthCalendar control. If only one date is selected, the Start and End property values will be equal. The SelectionRange can be changed by the user clicking a date while dragging the mouse pointer across the desired dates, or you can set the range in code. For example, you might want to have the user enter a date range into two TextBox controls or two DateTimePicker controls and set the SelectionRange based on those dates.

Example

[Visual Basic, C#, C++] The following example sets the SelectionRange property of a MonthCalendar control based on two dates entered into two TextBox controls when a Button is clicked. This code assumes new instances of a MonthCalendar control, two TextBox controls, and a Button have been created on a Form. You might consider adding code to validate the Text assigned to the text boxes to verify that they contain valid dates.

[Visual Basic] 
Private Sub button1_Click(sender As Object, e As EventArgs)
   ' Set the SelectionRange with start and end dates from text boxes.
   Try
      monthCalendar1.SelectionRange = New SelectionRange( _
        DateTime.Parse(textBox1.Text), _
        DateTime.Parse(textBox2.Text))
   Catch ex As Exception
      MessageBox.Show(ex.Message)
   End Try
End Sub

[C#] 
private void button1_Click(object sender,
                           EventArgs e)
{
   // Set the SelectionRange with start and end dates from text boxes.
   try
   {
      monthCalendar1.SelectionRange = new SelectionRange(
        DateTime.Parse(textBox1.Text),
        DateTime.Parse(textBox2.Text));
   }
   catch(Exception ex)
   {
      MessageBox.Show(ex.Message);
   }
}

[C++] 
private:
void button1_Click(Object* /*sender*/,
                   EventArgs* /*e*/)
{
   // Set the SelectionRange with start and end dates from text boxes.
   try
   {
      monthCalendar1->SelectionRange = new SelectionRange(
        DateTime::Parse(textBox1->Text),
        DateTime::Parse(textBox2->Text));
   }
   catch(Exception* ex)
   {
      MessageBox::Show(ex->Message);
   }
}

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Namespace: System.Windows.Forms

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

Assembly: System.Windows.Forms (in System.Windows.Forms.dll)

See Also

SelectionRange Members | System.Windows.Forms Namespace | DateTimePicker | DateTime

Show:
© 2014 Microsoft