Freigeben über


MonthCalendar.SelectionRange-Eigenschaft

Ruft den ausgewählten Datumsbereich für ein Monatskalender-Steuerelement ab oder legt diesen fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
<BindableAttribute(True)> _
Public Property SelectionRange As SelectionRange
'Usage
Dim instance As MonthCalendar
Dim value As SelectionRange

value = instance.SelectionRange

instance.SelectionRange = value
[BindableAttribute(true)] 
public SelectionRange SelectionRange { get; set; }
[BindableAttribute(true)] 
public:
property SelectionRange^ SelectionRange {
    SelectionRange^ get ();
    void set (SelectionRange^ value);
}
/** @property */
public SelectionRange get_SelectionRange ()

/** @property */
public void set_SelectionRange (SelectionRange value)
public function get SelectionRange () : SelectionRange

public function set SelectionRange (value : SelectionRange)

Eigenschaftenwert

Ein SelectionRange mit dem Anfangs- und Enddatum des ausgewählten Bereichs.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentOutOfRangeException

Der Start-Wert des zugewiesenen SelectionRange ist kleiner als das kleinstmögliche Datum für ein Monatskalender-Steuerelement.

- oder -

Der Start-Wert des zugewiesenen SelectionRange ist größer als das größtmögliche Datum für ein Monatskalender-Steuerelement.

- oder -

Der End-Wert des zugewiesenen SelectionRange ist kleiner als das kleinstmögliche Datum für ein Monatskalender-Steuerelement.

- oder -

Der End-Wert des zugewiesenen SelectionRange ist größer als das größtmögliche Datum für ein Monatskalender-Steuerelement.

Hinweise

Das Festlegen dieser Eigenschaft entspricht in der Funktion der SetSelectionRange-Methode. Sie können das Anfangs- und Enddatum gesondert festlegen, indem Sie entweder die SelectionStart-Eigenschaft oder SelectionEnd-Eigenschaft festlegen. Das Anfangs- und Enddatum kann nicht durch Festlegen des SelectionRange.Start-Eigenschaftenwerts oder SelectionRange.End-Eigenschaftenwerts der SelectionRange-Eigenschaft geändert werden. Verwenden Sie SelectionStart, SelectionEnd oder SetSelectionRange.

Wenn der Start-Eigenschaftenwert von SelectionRange größer als der End-Eigenschaftenwert ist, werden die Datumsangaben ausgetauscht – der End-Eigenschaftenwert wird zum Anfangsdatum und der Start-Eigenschaftenwert zum Enddatum.

Hinweis

Wenn in der Kalenderanzeige mit den Navigationsschaltflächen ein Bildlauf durchgeführt wird und gleichzeitig ein Bereich ausgewählt ist, kann dies zu unerwarteten Ergebnissen führen (beispielsweise wird der Datumsbereich nicht beibehalten). Bei der Anzeige eines einzelnen Monats mit einem Bereich vom 01.04.2001 bis zum 10.04.2001 wird beim Durchführen eines Bildlaufs im Kalender zum März der ausgewählte Bereich wie folgt geändert: 01.03.2001 bis zum 10.03.2001. Wenn mehrere Monate angezeigt werden, z. B. März und April mit einem ausgewählten Bereich vom 01.04.2001 bis zum 10.04.2001, wird beim Durchführen eines Bildlaufs im Kalender zurück zu Januar und Februar der ausgewählte Bereich wie folgt geändert: 01.01.2001 bis zum 10.01.2001.

Hinweis

Durch Festlegen des SelectionRange für ein MonthCalendar-Steuerelement mit aktivierten visuellen Stilen wird der Auswahlbereich im Steuerelement nicht korrekt gezeichnet.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

MonthCalendar-Klasse
MonthCalendar-Member
System.Windows.Forms-Namespace
MonthCalendar.SelectionRange-Eigenschaft
SelectionStart
MonthCalendar.SelectionEnd-Eigenschaft
SetSelectionRange