Freigeben über

DatePicker

Mit dem DatePicker-Steuerelement kann der Benutzer ein Datum auswählen, indem er es entweder in ein Textfeld eingibt, oder mithilfe eines Dropdown-Calendar-Steuerelements.

Die folgende Abbildung zeigt ein DatePicker-Steuerelement.

DatePicker-Steuerelement in verschiedenen Zuständen.

Viele Eigenschaften eines DatePicker-Steuerelements sind für die Verwaltung ihrer integrierten Calendar-Eigenschaft und Funktion identisch mit der entsprechenden Eigenschaft in Calendar. Insbesondere funktionieren die Eigenschaften DatePicker.IsTodayHighlighted, DatePicker.FirstDayOfWeek, DatePicker.BlackoutDates, DatePicker.DisplayDateStart, DatePicker.DisplayDateEnd, DatePicker.DisplayDate und DatePicker.SelectedDate identisch mit ihren Calendar-Gegenstücken. Weitere Informationen finden Sie unter Calendar.

Benutzer können ein Datum direkt in ein Textfeld eingeben, das die Text-Eigenschaft festlegt. Wenn DatePicker die eingegebene Zeichenfolge nicht in ein gültiges Datum umwandeln kann, wird das DateValidationError-Ereignis ausgelöst. Dies verursacht standardmäßig eine Ausnahme, aber ein Ereignishandler für DateValidationError kann die ThrowException-Eigenschaft auf false festlegen und verhindern, dass eine Ausnahme ausgelöst wird.

Stile und Vorlagen

Sie können den Standardwert ControlTemplate ändern, um dem DatePicker Steuerelement eine eindeutige Darstellung zu verleihen. Weitere Informationen finden Sie unter Was sind Formatvorlagen und Vorlagen? Und wie erstellen Sie eine Vorlage für ein Steuerelement.

Content-Eigenschaft

Dieses Steuerelement definiert keine Inhaltseigenschaft.

Bestandteile

In der folgenden Tabelle sind die benannten Teile für das DatePicker Steuerelement aufgeführt.

Teil Typ Description
PART_Button Button Die Dropdownschaltfläche, mit der das Kalenderpopup geöffnet wird.
PART_Popup Popup Das Popupmenü, das den Kalender für die Datumsauswahl enthält.
PART_Root Grid Der Stammbereich, der das Layout der Datumsauswahl enthält.
PART_TextBox DatePickerTextBox Das Textfeld, in dem der markierte Datumstext angezeigt wird.

Visuelle Zustände

In der folgenden Tabelle sind die visuellen Zustände für das DatePicker Steuerelement aufgeführt.

VisualState_Name Visualzustandsgruppe Name Description
Disabled CommonStates Das Steuerelement ist deaktiviert.
Normal CommonStates Das Steuerelement befindet sich im normalen Zustand.
UngültigerFokusiert Validierungszustände Das Steuerelement weist einen Validierungsfehler auf und hat den Tastaturfokus.
InvalidNichtFokussiert Validierungszustände Das Steuerelement weist einen Überprüfungsfehler auf, hat jedoch keinen Tastaturfokus.
Gültig Validierungszustände Das Steuerelement ist gültig und weist keine Überprüfungsfehler auf.

Datumsauswahl-Textfeld

DatePickerTextBox ist das Textfeld-Steuerelement, das innerhalb des DatePickerTextfelds verwendet wird.

Bestandteile

In der folgenden Tabelle sind die benannten Teile für das DatePickerTextBox Steuerelement aufgeführt.

Teil Typ Description
PART_ContentElement FrameworkElement Ein visuelles Element, das ein FrameworkElement enthalten kann. Der Text des Elements TextBox wird in diesem Element angezeigt.
PART-Wasserzeichen ContentControl Das Element, das den anfänglichen Text im DatePicker enthält.

Visuelle Zustände

In der folgenden Tabelle sind die visuellen Zustände für das DatePickerTextBox Steuerelement aufgeführt.

VisualState_Name Visualzustandsgruppe Name Description
Disabled CommonStates Dies DatePickerTextBox ist deaktiviert.
Mauszeiger CommonStates Der Mauszeiger befindet sich über dem DatePickerTextBox.
Normal CommonStates Der Standardstatus.
ReadOnly CommonStates Der Benutzer kann den Text in der DatePickerTextBox nicht ändern.
Focused FocusStates Das Steuerelement hat den Fokus.
Unfokussiert FocusStates Das Steuerelement hat keinen Fokus.
UngültigerFokusiert Validierungszustände Die angefügte Eigenschaft Validation.HasError ist true, und das Steuerelement hat den Fokus.
InvalidNichtFokussiert Validierungszustände Die Validation.HasError angefügte Eigenschaft ist true und das Steuerelement hat keinen Fokus.
Gültig Validierungszustände Das Steuerelement verwendet die Validation Klasse und die Validation.HasError angefügte Eigenschaft ist false.
Ohne Wasserzeichen WatermarkStates Der Benutzer hat Text in das DatePickerTextBox eingegeben oder ein Datum im DatePicker ausgewählt.
mit einem Wasserzeichen versehen WatermarkStates Das Steuerelement zeigt den ursprünglichen Text an. Dies DatePickerTextBox ist in diesem Zustand, wenn der Benutzer keinen Text eingegeben oder ein Datum ausgewählt hat.

Siehe auch

  • Last updated on