MonthCalendar.SetSelectionRange(DateTime, DateTime) Método

Definição

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.

Aplica-se a

Ver também