MonthCalendar.SelectionRange Propriedade

Definição

Obtém ou define o intervalo de datas selecionado para um controle do calendário do mês.

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

Valor da propriedade

SelectionRange

Um SelectionRange com as datas de início e término do intervalo selecionado.

Atributos

Exceções

O valor Start do SelectionRange atribuído é menor que a data mínima permitida para um controle de calendário mensal.

- ou - O valor Start do SelectionRange atribuído é maior que a data máxima permitida para um controle de calendário mensal.

- ou - O valor End do SelectionRange atribuído é menor que a data mínima permitida para um controle de calendário mensal.

- ou - O valor End do SelectionRange atribuído é maior que a data máxima permitida para um controle de calendário mensal.

Comentários

Definir essa propriedade é funcionalmente equivalente ao uso do SetSelectionRange método. Você pode definir as datas de início e término separadamente definindo as propriedades ou SelectionEnd as SelectionStart propriedades. Não é possível alterar as datas de início e término definindo os SelectionRange.Start valores de propriedade ou SelectionRange.End da SelectionRange propriedade. Você deve usar SelectionStart, SelectionEndou SetSelectionRange.

Se o Start valor da propriedade for SelectionRange maior que seu End valor de propriedade, as datas serão trocadas; o valor da End propriedade se tornará a data inicial e Start o valor da propriedade se tornará a data de término.

Observação

Rolar pela exibição do calendário com os botões de navegação quando um intervalo é selecionado pode causar resultados inesperados (por exemplo, o intervalo de datas não é preservado). Se você tiver um único mês exibido com um intervalo de 04/01/2001 a 10/04/2001, rolar o calendário até março alterará o intervalo selecionado da seguinte maneira: 03/01/2001 a 03/10/2001. Se você tiver vários meses exibidos, como março e abril com um intervalo selecionado de 04/01/2001 a 10/04/2001, rolar o calendário de volta para janeiro e fevereiro alterará o intervalo selecionado da seguinte maneira: 01/01/2001 a 01/10/2001.

Observação

Definir o SelectionRange MonthCalendar controle que tem estilos visuais habilitados resultará no intervalo de seleção que não está pintando corretamente no controle.

Aplica-se a

Confira também