Takvim tarih seçicisi

Takvim tarih seçicisi, haftanın günü veya takvimin doluluğu gibi bağlamsal bilgilerin önemli olduğu takvim görünümünden tek bir tarih seçmek için iyileştirilmiş bir açılan liste denetimidir. Ek bağlam sağlamak veya kullanılabilir tarihleri sınırlamak için takvimi değiştirebilirsiniz.

Doğru kontrol bu mu?

Kullanıcının bağlamsal takvim görünümünden tek bir tarih seçmesine izin vermek için takvim tarih seçicisi kullanın. Randevu veya kalkış tarihi seçme gibi şeyler için kullanın.

Kullanıcının, takvimin bağlamının önemli olmadığı bilinen bir tarihi (örneğin, doğum tarihi) seçmesine izin vermek için bir tarih seçici kullanmayı göz önünde bulundurun.

Doğru denetimi seçme hakkında daha fazla bilgi için Tarih ve saat denetimleri makalesine bakın.

Örnekler

Tarih ayarlanmamışsa giriş noktası yer tutucu metni görüntüler; aksi takdirde, seçilen tarihi görüntüler. Kullanıcı giriş noktasını seçtiğinde, kullanıcının tarih seçimi yapması için bir takvim görünümü genişler. Takvim görünümü diğer kullanıcı arabirimini katmanlar; diğer kullanıcı arabirimini yoldan çekmez.

Takvim tarih seçicisi oluşturma

• Önemli API'ler:CalendarDatePicker sınıfı, Date özelliği, DateChanged olayı

WinUI 3 Galeri uygulamasını açın ve CalendarDatePicker'ı çalışır durumda görün

WinUI 3 Galeri uygulaması, WinUI denetimlerinin ve özelliklerinin etkileşimli örneklerini içerir. uygulamayı Microsoft Store adresinden alın veya GitHub üzerindeki kaynak koduna göz atın.

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

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

Sonuçta elde edilen takvim tarih seçicisi şöyle görünür:

Takvim tarih seçicisi, tarih seçmek için bir iç CalendarView'a sahiptir. IsTodayHighlighted ve FirstDayOfWeek gibi CalendarView özelliklerinin bir alt kümesi CalendarDatePicker'da bulunur ve değiştirmenizi sağlamak için iç CalendarView'a iletilir.

Ancak, iç CalendarView'un SelectionMode değerini birden çok seçime izin verecek şekilde değiştiremezsiniz. Kullanıcının birden çok tarih seçmesine izin vermeniz veya takvimin her zaman görünür olması gerekiyorsa, takvim tarih seçicisi yerine takvim görünümü kullanmayı göz önünde bulundurun. Takvim görünümünü nasıl değiştirebileceğiniz hakkında daha fazla bilgi için Takvim görünümü makalesine bakın.

Tarih seçme

Seçili tarihi almak veya ayarlamak için Date özelliğini kullanın. Varsayılan olarak Date özelliği null'tır. Kullanıcı takvim görünümünde bir tarih seçtiğinde, bu özellik güncelleştirilir. Kullanıcı, takvim görünümünde seçili tarihe tıklayarak tarihi temizleyerek seçimi kaldırabilir.

Kodunuzda tarihi şöyle ayarlayabilirsiniz.

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

Kodda Date değerini ayarladığınızda, değer MinDate ve MaxDate özellikleriyle kısıtlanır.

• TarihMinDate değerinden küçükse, değer MinDate olarak ayarlanır.
• TarihMaxDate değerinden büyükse, değer MaxDate olarak ayarlanır.

Date değeri değiştiğinde bildirim almak için DateChanged olayını işleyebilirsiniz.

Uyarı

Tarih değerleri hakkında önemli bilgiler için Tarih ve saat denetimleri makalesindeki DateTime ve Calendar değerleri bölümüne bakın.

Üst bilgi ve yer tutucu metni ayarlama

Kullanıcıya ne için kullanıldığına ilişkin bir gösterge vermek için takvim tarih seçicisine Üst Bilgi (veya etiket) ve PlaceholderText (veya filigran) ekleyebilirsiniz. Üst bilginin görünümünü özelleştirmek için Header yerine HeaderTemplate özelliğini ayarlayabilirsiniz.

Varsayılan yer tutucu metin "bir tarih seçin" şeklindedir. PlaceholderText özelliğini boş bir dizeye ayarlayarak bunu kaldırabilir veya burada gösterildiği gibi özel metin sağlayabilirsiniz.

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

İlgili makaleler

• Tarih ve saat denetimleri
• Takvim görünümü
• Tarih seçici
• Saat seçici