Naptárdátumválasztó

A naptárdátumválasztó egy legördülő vezérlő, amely egyetlen dátum naptárnézetből való kiválasztására van optimalizálva, ahol fontos a környezetfüggő információ, például a hét napja vagy a naptár teljessége. Módosíthatja a naptárt úgy, hogy további környezetet adjon meg, vagy korlátozza a rendelkezésre álló dátumokat.

Ez a megfelelő vezérlő?

Naptári dátum kiválasztó használatával lehetővé teheti, hogy a felhasználó egy dátumot válasszon ki a kontextustól függő naptárnézetben. Olyan dolgokhoz használhatja, mint a találkozó vagy az indulási dátum kiválasztása.

Ha lehetővé szeretné tenni, hogy a felhasználó válasszon egy ismert dátumot, például egy születési dátumot, ahol a naptár környezete nem fontos, érdemes lehet dátumválasztót használnia.

A megfelelő vezérlőelem kiválasztásáról további információt a Dátum- és idővezérlők című cikkben talál.

Példák

A belépési pont helyőrző szöveget jelenít meg, ha nincs beállítva dátum; ellenkező esetben megjeleníti a kiválasztott dátumot. Amikor a felhasználó kiválasztja a belépési pontot, a felhasználó naptárnézete kinyílik a dátumkijelöléshez. A naptár nézet átfedi a többi felhasználói felület elemet; nem tolja félre őket.

Naptárdátumválasztó létrehozása

• Fontos API-k:CalendarDatePicker osztály, Date tulajdonság, DateChanged esemény

Nyissa meg a WinUI 3 Katalógus alkalmazást, és tekintse meg a CalendarDatePickert működés közben

A WinUI 3 Katalógus alkalmazás interaktív példákat tartalmaz a WinUI vezérlőire és funkcióira. Kérje le az alkalmazást a Microsoft Áruházból vagy keresse meg a forráskódot a GitHub webhelyen.

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

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

Az eredményként kapott naptárdátumválasztó a következőképpen néz ki:

A naptárdátumválasztó belső CalendarView nézetet biztosít a dátum kiválasztásához. A CalendarView-tulajdonságok egy részhalmaza, például az IsTodayHighlighted és a FirstDayOfWeek, a CalendarDatePickeren található, és a rendszer a belső CalendarView-ra továbbítja a módosításhoz.

A belső CalendarView SelectionMode elemét azonban nem módosíthatja több kijelölés engedélyezéséhez. Ha azt szeretné, hogy egy felhasználó több dátumot válasszon, vagy egy naptár mindig látható legyen, érdemes lehet naptárnézetet használnia naptárdátumválasztó helyett. A naptár megjelenítésének módosításáról további információt a Naptár nézetet ismertető cikkben talál.

Dátumok kiválasztása

A Dátum tulajdonság használatával lekérheti vagy beállíthatja a kijelölt dátumot. Alapértelmezés szerint a Date tulajdonság null értékű. Ha egy felhasználó kijelöl egy dátumot a naptárnézetben, a tulajdonság frissül. A felhasználó úgy törölheti a dátumot, hogy a naptár nézetben a kijelölt dátumra kattint a kijelölés megszüntetéséhez.

A dátumot így állíthatja be a kódban.

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

Amikor a dátumot kódban állítja be, az értéket a MinDate és a MaxDate tulajdonságok korlátozzák.

• Ha a Dátum kisebb, mint a MinDate, az érték MinDate értékre van állítva.
• Ha a dátum nagyobb, mint a MaxDate, akkor az érték MaxDate értékre van állítva.

Kezelheti a DateChanged eseményt , hogy értesítést kapjon a Dátum értékének módosításáról.

Megjegyzés:

A dátumértékekkel kapcsolatos fontos információkért tekintse meg a DateTime és a Naptár értékeket a Dátum és idő vezérlőelemek című cikkben.

Fejléc és helyőrző szöveg beállítása

Fejlécet (vagy címkét) és helyőrzőszöveget (vagy vízjelet) is hozzáadhat a naptárdátumválasztóhoz, hogy a felhasználó jelezze, mire használják. A fejléc megjelenésének testreszabásához a Fejléc helyett a HeaderTemplate tulajdonságot állíthatja be.

Az alapértelmezett helyőrző szöveg a "dátum kijelölése". Ezt úgy távolíthatja el, hogy a PlaceholderText tulajdonságot üres sztringre állítja, vagy egyéni szöveget is megadhat az itt látható módon.

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

Kapcsolódó cikkek

• Dátum- és idővezérlők
• Naptár nézet
• Dátumválasztó
• Időválasztó