MonthCalendar.SelectionStart Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origem:

MonthCalendar.cs

Obtém ou define a data de início do intervalo de datas selecionado.

public:
 property DateTime SelectionStart { DateTime get(); void set(DateTime value); };

[System.ComponentModel.Browsable(false)]
public DateTime SelectionStart { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.SelectionStart : DateTime with get, set

Public Property SelectionStart As DateTime

Valor da propriedade

DateTime

Um DateTime que indica a primeira data no intervalo de seleção.

Atributos

BrowsableAttribute

Exceções

ArgumentOutOfRangeException

O valor da data é menor que MinDate.

- ou -

O valor da data é maior que MaxDate.

Exemplos

O exemplo de código a seguir demonstra como usar as propriedades e SelectionEnd as SelectionStart propriedades. Para executar o exemplo, cole o código a seguir em um formulário que contém um MonthCalendar controle nomeado MonthCalendar1e chame o ShowAWeeksVacationOneMonthFromToday método do construtor do formulário ou Load do método de tratamento de eventos.

// Computes a week one month from today.
void ShowAWeeksVacationOneMonthFromToday()
{
   DateTime today = this->MonthCalendar1->TodayDate;
   DateTime vacationStart = today.AddMonths(1);
   DateTime vacationEnd = vacationStart.AddDays(7);

   // Select the week using SelectionStart and SelectionEnd.
   this->MonthCalendar1->SelectionStart = vacationStart.AddDays(-1);
   this->MonthCalendar1->SelectionEnd = vacationEnd.AddDays(-1);
}

// Computes a week one month from today.
private void ShowAWeeksVacationOneMonthFromToday()
{
    DateTime today = this.MonthCalendar1.TodayDate;
    DateTime vacationStart = today.AddMonths(1);
    DateTime vacationEnd = vacationStart.AddDays(7);

    // Select the week using SelectionStart and SelectionEnd.
    this.MonthCalendar1.SelectionStart = vacationStart.AddDays(-1);
    this.MonthCalendar1.SelectionEnd = vacationEnd.AddDays(-1);
}

' Computes a week one month from today.
Private Sub ShowAWeeksVacationOneMonthFromToday()
    Dim today As Date = monthCalendar1.TodayDate
    Dim vacationStart = today.AddMonths(1)
    Dim vacationEnd = vacationStart.AddDays(7)

    Me.monthCalendar1.SelectionStart = vacationStart.AddDays(-1)
    Me.monthCalendar1.SelectionEnd = vacationEnd.AddDays(-1)
End Sub

Comentários

Se você definir o valor da SelectionStart propriedade como uma data posterior ao valor atual da SelectionEnd propriedade, SelectionEnd será definido automaticamente como igual a SelectionStart.

Se você definir uma data em SelectionStart que faça com que a seleção exceda o número de dias especificado pela MaxSelectionCount propriedade, o valor será SelectionEnd ajustado; SelectionEnd será definido automaticamente para que o número de dias selecionados seja igual a MaxSelectionCount.

Observação

MaxSelectionCount representa o número de dias na seleção, não a diferença entre SelectionStart e SelectionEnd. Por exemplo, se for MaxSelectionCount 7 (o padrão), SelectionStart e SelectionEnd não poderá ter mais de seis dias de diferença.

Observação

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

Confira também

• SelectionRange
• SelectionEnd
• SetSelectionRange(DateTime, DateTime)