Kalenderdatumkiezer

De kalenderdatumkiezer is een vervolgkeuzelijst die is geoptimaliseerd voor het kiezen van één datum in een agendaweergave, waarbij contextuele informatie zoals de dag van de week of de volledige agenda belangrijk is. U kunt de agenda wijzigen om extra context te bieden of om de beschikbare datums te beperken.

Is dit de juiste controle?

Gebruik een kalenderdatumkiezer om een gebruiker één datum uit een contextuele agendaweergave te laten kiezen. Gebruik dit voor zaken zoals het kiezen van een afspraak of vertrekdatum.

Als u een gebruiker een bekende datum wilt laten kiezen, zoals een geboortedatum, waarbij de context van de agenda niet belangrijk is, kunt u overwegen een datumkiezer te gebruiken.

Zie het artikel Datum- en tijdbesturingselementen voor meer informatie over het kiezen van het juiste besturingselement.

Voorbeelden

In het invoerpunt wordt tekst van tijdelijke aanduidingen weergegeven als er geen datum is ingesteld; anders wordt de gekozen datum weergegeven. Wanneer de gebruiker het invoerpunt selecteert, wordt een agendaweergave uitgebreid zodat de gebruiker een datumselectie kan maken. De agendaweergave overlays andere gebruikersinterfaces; het verplaatst geen andere gebruikersinterfaces opzij.

Een kalenderdatumkiezer maken

De WinUI 3 Gallery-app bevat interactieve voorbeelden van de meeste Besturingselementen, functies en functionaliteit van WinUI 3. Haal de app op uit de Microsoft Store of haal de broncode op GitHub op

<CalendarDatePicker x:Name="arrivalCalendarDatePicker" Header="Calendar"/>

CalendarDatePicker arrivalCalendarDatePicker = new CalendarDatePicker();
arrivalCalendarDatePicker.Header = "Calendar";

De resulterende kalenderdatumkiezer ziet er als volgt uit:

De kalenderdatumkiezer heeft een interne CalendarView voor het kiezen van een datum. Een subset van CalendarView-eigenschappen, zoals IsTodayHighlighted en FirstDayOfWeek, bestaat op CalendarDatePicker en wordt doorgestuurd naar de interne CalendarView om het te wijzigen.

U kunt de SelectionMode van de interne CalendarView echter niet wijzigen om meerdere selecties toe te staan. Als u een gebruiker meerdere datums wilt laten kiezen of een agenda altijd zichtbaar wilt maken, kunt u overwegen een agendaweergave te gebruiken in plaats van een kalenderdatumkiezer. Zie het artikel Agendaweergave voor meer informatie over hoe u de agendaweergave kunt wijzigen.

Datums selecteren

Gebruik de eigenschap Datum om de geselecteerde datum op te halen of in te stellen. De eigenschap Date is standaard null. Wanneer een gebruiker een datum selecteert in de agendaweergave, wordt deze eigenschap bijgewerkt. Een gebruiker kan de datum wissen door te klikken op de geselecteerde datum in de agendaweergave om de selectie ervan op te heffen.

U kunt de datum in uw code als volgt instellen.

myCalendarDatePicker.Date = new DateTime(1977, 1, 5);

Wanneer u de datum in code instelt, wordt de waarde beperkt door de eigenschappen MinDate en MaxDate .

• Als datum kleiner is dan MinDate, wordt de waarde ingesteld op MinDate.
• Als datum groter is dan MaxDate, wordt de waarde ingesteld op MaxDate.

U kunt de datumwijzigingsgebeurtenis afhandelen om een melding te ontvangen wanneer de datumwaarde is gewijzigd.

Een koptekst en tijdelijke aanduiding voor tekst instellen

U kunt een koptekst (of label) en tijdelijke aanduidingTekst (of watermerk) toevoegen aan de kalenderdatumkiezer om de gebruiker een indicatie te geven van waar deze voor wordt gebruikt. Als u het uiterlijk van de koptekst wilt aanpassen, kunt u de eigenschap HeaderTemplate instellen in plaats van Koptekst.

De standaardtekst van de tijdelijke aanduiding is 'selecteer een datum'. U kunt dit verwijderen door de eigenschap PlaceholderText in te stellen op een lege tekenreeks of u kunt aangepaste tekst opgeven, zoals hier wordt weergegeven.

<CalendarDatePicker x:Name="arrivalCalendarDatePicker" Header="Arrival date"
                    PlaceholderText="Choose your arrival date"/>

UWP en WinUI 2

API's voor deze controle bevinden zich in de naamruimte Windows.UI.Xaml.Controls.

U wordt aangeraden de nieuwste WinUI 2 te gebruiken om de meest recente stijlen en sjablonen voor alle besturingselementen te verkrijgen. WinUI 2.2 of hoger bevat een nieuwe sjabloon voor dit besturingselement dat gebruikmaakt van afgeronde hoeken. Zie Hoekstraal voor meer informatie.

Verwante artikelen

• Besturingselementen voor datum en tijd
• Kalenderweergave
• Datumkiezer
• tijdkiezer