Pemilih Tanggal

Kontrol DatePicker memungkinkan pengguna untuk memilih tanggal dengan mengetikkannya ke bidang teks atau dengan menggunakan kontrol Calendar drop-down.

Ilustrasi berikut menunjukkan DatePicker.

Kontrol DatePicker di status yang berbeda.

Banyak properti kontrol DatePicker adalah untuk mengelola Calendarbawaannya, dan berfungsi secara identik dengan properti yang setara di Calendar. Secara khusus, properti DatePicker.IsTodayHighlighted, DatePicker.FirstDayOfWeek, DatePicker.BlackoutDates, DatePicker.DisplayDateStart, DatePicker.DisplayDateEnd, DatePicker.DisplayDate, dan DatePicker.SelectedDate berfungsi secara identik dengan mitra Calendar mereka. Untuk informasi selengkapnya, lihat Calendar .

Pengguna dapat mengetik tanggal langsung ke bidang teks, yang mengatur properti Text. Jika DatePicker tidak dapat mengonversi string yang dimasukkan ke tanggal yang valid, peristiwa DateValidationError akan dinaikkan. Secara default, ini menyebabkan pengecualian, tetapi penanganan aktivitas untuk DateValidationError dapat mengatur properti ThrowException ke false dan mencegah pengecualian dinaikkan.

Gaya dan templat

Anda dapat memodifikasi default ControlTemplate untuk memberi DatePicker kontrol tampilan yang unik. Untuk informasi selengkapnya, lihat Apa itu gaya dan templat? dan Cara membuat templat untuk kontrol.

Properti konten

Kontrol ini tidak menentukan properti isi.

Bagian

Tabel berikut mencantumkan bagian-bagian yang diberi nama dari kontrol DatePicker.

Bagian Tipe Description
PART_Button Button Tombol drop-down yang membuka popup kalender.
PART_Popup Popup Popup yang berisi kalender untuk pilihan tanggal.
PART_Root Grid Panel inti yang berisi tata letak pemilih tanggal.
PART_TextBox DatePickerTextBox Kotak teks yang menampilkan teks tanggal terpilih.

Keadaan visual

Tabel berikut mencantumkan status visual untuk DatePicker kontrol.

Nama VisualState Nama VisualStateGroup Description
Disabled CommonStates Kontrol dinonaktifkan.
Biasa CommonStates Kontrol berada dalam keadaan normal.
FokusTidakValid StatusValidasi Kontrol memiliki kesalahan validasi dan memiliki fokus keyboard.
Tidak valid dan Tidak Difokuskan StatusValidasi Kontrol memiliki kesalahan validasi tetapi tidak memiliki fokus keyboard.
Sah StatusValidasi Kontrol valid dan tidak memiliki kesalahan validasi.

DatePickerTextBox

DatePickerTextBox adalah kontrol kotak teks yang digunakan dalam DatePicker.

Bagian

Tabel berikut mencantumkan bagian-bagian yang diberi nama dari kontrol DatePickerTextBox.

Bagian Tipe Description
PART_ContentElement FrameworkElement Elemen visual yang dapat berisi FrameworkElement. Teks TextBox ditampilkan dalam elemen ini.
Bagian_TandaAir ContentControl Elemen yang berisi teks awal di DatePicker.

Keadaan visual

Tabel berikut mencantumkan status visual untuk DatePickerTextBox kontrol.

Nama VisualState Nama VisualStateGroup Description
Disabled CommonStates DatePickerTextBox dinonaktifkan.
MouseOver CommonStates Penunjuk mouse diposisikan di atas DatePickerTextBox.
Biasa CommonStates Keadaan default.
ReadOnly CommonStates Pengguna tidak dapat mengubah teks di DatePickerTextBox.
Terfokus FocusStates Kontrol berfokus.
Tidak fokus FocusStates Kontrol tidak memiliki fokus.
FokusTidakValid StatusValidasi Properti Validation.HasError terlampir adalah true dan kontrol memiliki fokus.
Tidak valid dan Tidak Difokuskan StatusValidasi Properti Validation.HasError terlampir adalah true dan kontrol tidak memiliki fokus.
Sah StatusValidasi Kontrol menggunakan Validation kelas dan properti terlampir Validation.HasError adalah false.
Tidak ditandai Tanda Air Pengguna telah memasukkan teks ke DatePickerTextBox dalam atau memilih tanggal di DatePicker.
Tanda Air Tanda Air Kontrol menampilkan teks awalnya. DatePickerTextBox berada dalam status ini ketika pengguna belum memasukkan teks atau memilih tanggal.

Lihat juga

  • Last updated on