MonthCalendar.SetSelectionRange(DateTime, DateTime) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Define as datas selecionadas num controlo mensal do calendário para o intervalo de datas especificado.
public:
void SetSelectionRange(DateTime date1, DateTime date2);
public void SetSelectionRange(DateTime date1, DateTime date2);
member this.SetSelectionRange : DateTime * DateTime -> unit
Public Sub SetSelectionRange (date1 As DateTime, date2 As DateTime)
Parâmetros
- date1
- DateTime
A data de início do intervalo de seleção.
- date2
- DateTime
A data final do intervalo de seleção.
Exceções
date1 é inferior à data mínima permitida para um controlo mensal do calendário.
-ou-
date1 é superior à data máxima permitida para um controlo mensal do calendário.
-ou-
date2 é inferior à data mínima permitida para um controlo mensal do calendário.
-ou-
date2 é superior à data máxima permitida para um controlo mensal do calendário.
Esta exceção só será lançada se MinDate ou MaxDate tiver sido definida explicitamente.
Observações
Usar este método é funcionalmente equivalente a definir a propriedade SelectionRange . Pode definir as datas de início e fim separadamente, definindo a SelectionStart propriedade ou SelectionEnd .
Se definir o date1 parâmetro superior ao date2 parâmetro, ambas as datas são definidas para o date1 valor.
Note
Percorrer o ecrã 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 tiver um único mês apresentado com um intervalo de 01/04/2001 a 10/04/2001, ao recuar o calendário, o intervalo selecionado muda da seguinte forma: 01/03/2001 a 10/03/2001. Se tiver vários meses apresentados, como março e abril com um intervalo selecionado de 04/01/2001 a 04/10/2001, ao recuar o calendário até janeiro e fevereiro, altera o intervalo selecionado da seguinte forma: 01/01/2001 a 01/10/2001.
Note
Definir o SelectionRange para um MonthCalendar controlo que tenha estilos visuais ativados fará com que a gama de seleção não seja pintada corretamente no controlo.