DatePicker (på engelska)

Med kontrollen DatePicker kan användaren välja ett datum genom att antingen skriva in det i ett textfält eller använda kontrollen i listruta Calendar.

Följande illustration visar en DatePicker.

DatePicker-kontroll i olika tillstånd.

Många av egenskaperna för en DatePicker kontroll används för att hantera den inbyggda Calendaroch fungerar identiskt med motsvarande egenskap i Calendar. I synnerhet fungerar egenskaperna DatePicker.IsTodayHighlighted, DatePicker.FirstDayOfWeek, DatePicker.BlackoutDates, DatePicker.DisplayDateStart, DatePicker.DisplayDateEnd, DatePicker.DisplayDateoch DatePicker.SelectedDate identiskt med deras Calendar motsvarigheter. Mer information finns i Calendar.

Användare kan skriva ett datum direkt i ett textfält, vilket anger egenskapen Text. Om DatePicker inte kan konvertera den angivna strängen till ett giltigt datum aktiveras händelsen DateValidationError. Som standard orsakar detta ett undantag, men en händelsehanterare för DateValidationError kan ange egenskapen ThrowException till false och förhindra att ett undantag utlöses.

Formatmallar och stilar

Du kan ändra standardvärdet ControlTemplate för att ge DatePicker kontrollen ett unikt utseende. Mer information finns i Vad är formatmallar och mallar? och Hur skapar du en mall för en kontroll.

Innehållsegenskap

Den här kontrollen definierar inte en innehållsegenskap.

Delar

I följande tabell visas de namngivna DatePicker delarna för kontrollen.

Del Typ Description
PART_Button Button Den nedrullningsbara knappen som öppnar kalender-popup-fönstret.
PART_Popup Popup Popup-fönstret som innehåller kalendern för datumval.
PART_Root Grid Rotpanelen som innehåller layouten för datumväljaren.
PART_TextBox DatePickerTextBox Textrutan som visar den markerade datumtexten.

Visuella tillstånd

I följande tabell visas de visuella tillstånden DatePicker för kontrollen.

VisualState-namn VisualStateGroup-namn Description
Disabled CommonStates Kontrollen är inaktiverad.
Normalt CommonStates Kontrollen är i sitt normala tillstånd.
OgiltigFocus ValidationStates Kontrollen har ett verifieringsfel och har tangentbordsfokus.
OgiltigInteIFokus ValidationStates Kontrollen har ett verifieringsfel men har inte tangentbordsfokus.
Giltigt ValidationStates Kontrollen är giltig och har inga verifieringsfel.

DatePickerTextBox

DatePickerTextBox är textrutekontrollen som används i DatePicker.

Delar

I följande tabell visas de namngivna DatePickerTextBox delarna för kontrollen.

Del Typ Description
PART_InnehållsElement FrameworkElement Ett visuellt element som kan innehålla en FrameworkElement. Texten i TextBox visas i det här elementet.
PART_Watermark ContentControl Elementet som innehåller den inledande texten i DatePicker.

Visuella tillstånd

I följande tabell visas de visuella tillstånden DatePickerTextBox för kontrollen.

VisualState-namn VisualStateGroup-namn Description
Disabled CommonStates DatePickerTextBox är inaktiverad.
Musöver CommonStates Muspekaren är placerad över DatePickerTextBox.
Normalt CommonStates Standardtillståndet.
Skrivskyddat CommonStates Användaren kan inte ändra texten i DatePickerTextBox.
Focused FocusStates Kontrollen har fokus.
Ofokuserat FocusStates Kontrollen har inte fokus.
OgiltigFocus ValidationStates Den Validation.HasError kopplade egenskapen är true och styrningen har fokus.
OgiltigInteIFokus ValidationStates Den Validation.HasError bifogade egenskapen är true och kontrollen har inte fokus.
Giltigt ValidationStates Kontrollen använder Validation klassen och den Validation.HasError anslutna egenskapen är false.
Utan vattenmärke WatermarkStates Användaren har angett text i DatePickerTextBox eller valt ett datum i DatePicker.
Vattenstämpel WatermarkStates Kontrollen visar sin inledande text. DatePickerTextBox är i det här tillståndet när användaren inte har angett text eller valt ett datum.

Se även

  • Last updated on