MonthCalendar.SelectionStart Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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 SelectionStart propriedades e SelectionEnd . Para executar o exemplo, cole o código a seguir em um formulário que contém um MonthCalendar controle chamado MonthCalendar1e chame o ShowAWeeksVacationOneMonthFromToday método do construtor do formulário ou Load do método de manipulação 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 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 de SelectionEnd será 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 MaxSelectionCount for 7 (o padrão), SelectionStart e SelectionEnd não poderá ter mais de seis dias de diferença.

Observação

Definir o SelectionRange para um MonthCalendar controle que tenha estilos visuais habilitados resultará na não pintura correta do intervalo de seleção no controle.

Confira também

• SelectionRange
• SelectionEnd
• SetSelectionRange(DateTime, DateTime)