SelectionRange Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Representa um intervalo da seleção de datas em um controle de calendário mensal.

public ref class SelectionRange sealed

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.SelectionRangeConverter))]
public sealed class SelectionRange

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.SelectionRangeConverter))>]
type SelectionRange = class

Public NotInheritable Class SelectionRange

Herança

Object

SelectionRange

Atributos

TypeConverterAttribute

Exemplos

O exemplo a seguir define a SelectionRange propriedade de um MonthCalendar controle com base em duas datas inseridas em dois TextBox controles quando um Button é clicado. Esse código pressupõe que novas instâncias de um MonthCalendar controle, dois TextBox controles e um Button tenham sido criados em um Form. Você pode considerar a adição de código para validar o Text atribuído às caixas de texto para verificar se elas contêm datas válidas.

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

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);
   }
}

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

Comentários

O SelectionRange é a data ou as datas selecionadas e realçadas no MonthCalendar controle. Se apenas uma data for selecionada, os valores de Start propriedade e End serão iguais. O SelectionRange pode ser alterado pelo usuário clicando em uma data enquanto arrasta o ponteiro do mouse entre as datas desejadas ou você pode definir o intervalo no código. Por exemplo, talvez você queira que o usuário insira um intervalo de datas em dois TextBox controles ou dois DateTimePicker controles e defina o SelectionRange com base nessas datas.

Construtores

SelectionRange()	Inicializa uma nova instância da classe SelectionRange.
SelectionRange(DateTime, DateTime)	Inicializa uma nova instância da classe SelectionRange com as datas de início e término especificadas.
SelectionRange(SelectionRange)	Inicializa uma nova instância da classe SelectionRange com o intervalo de seleção especificado.

Propriedades

End	Obtém ou define a data e a hora de término do intervalo de seleção.
Start	Obtém ou define a data e a hora de início do intervalo de seleção.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o SelectionRange.

Confira também

• DateTimePicker
• DateTime