Sdílet prostřednictvím

Výběr data v kalendáři

Výběr data kalendáře je rozevírací ovládací prvek, který je optimalizovaný pro výběr jednoho data v zobrazení kalendáře, kde jsou důležité kontextové informace, jako je den v týdnu nebo plná dostupnost kalendáře. Kalendář můžete upravit tak, aby poskytoval další kontext nebo omezil dostupná data.

Je to správná kontrola?

Pomocí nástroje pro výběr data kalendáře umožníte uživateli vybrat jedno datum z kontextového zobrazení kalendáře. Můžete ho použít pro věci, jako je volba události nebo data odjezdu.

Pokud chcete, aby si uživatel vybral známé datum, například datum narození, kde kontext kalendáře není důležitý, zvažte použití výběru data.

Další informace o výběru správného ovládacího prvku najdete v článku Ovládací prvky data a času .

Examples

Vstupní bod zobrazí zástupný text, pokud není nastaveno datum; v opačném případě zobrazí zvolené datum. Když uživatel vybere vstupní bod, rozbalí se zobrazení kalendáře, aby uživatel vybral datum. Zobrazení kalendáře se překrývá s jinými uživatelskými rozhraními; neodsunuje je stranou.

Snímek obrazovky ukazuje prazdné textové pole pro výběr data, které je poté vyplněno, a pod ním je kalendář.

Vytvoření výběru data kalendáře

Otevřete aplikaci Galerie WinUI 3 a podívejte se na CalendarDatePicker v akci.

Ikona galerie WinUI 3 Aplikace Galerie WinUI 3 obsahuje interaktivní příklady ovládacích prvků a funkcí WinUI. Získejte aplikaci z Microsoft Store nebo vyhledejte zdrojový kód na GitHub. 
<CalendarDatePicker x:Name="arrivalCalendarDatePicker" Header="Calendar"/>

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

Výběr data pomocí kalendáře vypadá takto:

Snímek obrazovky s vyplněným výběrem data kalendáře s popiskem Kalendář

Výběr data v kalendáři obsahuje interní Zobrazení kalendáře pro výběr data. Podmnožina vlastností CalendarView, například IsTodayHighlighted a FirstDayOfWeek, existují v CalendarDatePicker a jsou přeposílány do interního CalendarView, aby je bylo možné upravovat.

Nemůžete ale změnit SelectionMode interního objektu CalendarView tak, aby umožňoval vícenásobný výběr. Pokud potřebujete nechat uživatele vybrat více kalendářních dat nebo potřebujete, aby byl kalendář vždy viditelný, zvažte použití zobrazení kalendáře místo výběru data kalendáře. Další informace o tom, jak můžete změnit zobrazení kalendáře, najdete v článku o zobrazení kalendáře .

Výběr kalendářních dat

Pomocí vlastnosti Date můžete získat nebo nastavit vybrané datum. Ve výchozím nastavení má vlastnost Date hodnotu null. Když uživatel vybere datum v zobrazení kalendáře, tato vlastnost se aktualizuje. Uživatel může zrušit výběr data kliknutím na vybrané datum v zobrazení kalendáře.

Datum v kódu můžete nastavit takto.

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

Když nastavíte date v kódu, hodnota je omezena vlastnostmi MinDate a MaxDate .

  • Pokud je datum menší než MinDate, je hodnota nastavená na MinDate.
  • Pokud je datum větší než MaxDate, je hodnota nastavená na MaxDate.

Událost DateChanged můžete zpracovat tak, aby byla upozorněna, když se hodnota Date změnila.

Poznámka:

Důležité informace o hodnotách kalendářních dat naleznete v části Hodnoty DateTime a Calendar v článku Ovládací prvky data a času.

Nastavení záhlaví a zástupného textu

Do výběru data kalendáře můžete přidat záhlaví (nebo popisek) a zástupný text (nebo vodoznak), aby uživatel mohl indikovat, k čemu se používá. Chcete-li přizpůsobit vzhled záhlaví, můžete nastavit HeaderTemplate vlastnost namísto Header.

Výchozí zástupný text je "vybrat datum". Můžete to odebrat nastavením vlastnosti PlaceholderText na prázdný řetězec nebo můžete zadat vlastní text, jak je znázorněno zde.

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