TimePicker
.NET Multi-platform App UI (.NET MAUI) TimePicker memanggil kontrol pemilih waktu platform dan memungkinkan Anda untuk memilih waktu.
TimePicker menentukan properti berikut:
Time
jenisTimeSpan
, waktu yang dipilih, yang default keTimeSpan
0. Jenis menunjukkanTimeSpan
durasi waktu sejak tengah malam.Format
jenisstring
, string pemformatan .NET standar atau kustom , yang default ke "t", pola waktu singkat.TextColor
jenis Color, warna yang digunakan untuk menampilkan waktu yang dipilih.FontAttributes
jenisFontAttributes
, yang default keFontAtributes.None
.FontFamily
jenisstring
, yang default kenull
.FontSize
jenisdouble
, yang default ke -1.0.CharacterSpacing
, dari jenisdouble
, adalah penspasian TimePicker antara karakter teks.
Semua properti ini didukung oleh BindableProperty objek, yang berarti dapat ditata, dan properti dapat menjadi target pengikatan data. Properti Time
memiliki mode BindingMode.TwoWay
pengikatan default , yang berarti dapat menjadi target pengikatan data dalam aplikasi yang menggunakan pola Model-View-ViewModel (MVVM).
Catatan
TimePicker tidak menyertakan peristiwa untuk menunjukkan nilai baru yang dipilihTime
. Jika Anda perlu diberi tahu tentang hal ini, Anda dapat menambahkan penanganan aktivitas untuk peristiwa tersebut PropertyChanged
.
Selain itu, TimePicker menentukan TimeSelected peristiwa, yang dimunculkan saat waktu yang dipilih berubah. Objek TimeChangedEventArgs yang menyertai TimeSelected
peristiwa memiliki NewTime
properti dan OldTime
, yang masing-masing menentukan waktu baru dan lama.
Membuat TimePicker
Time
Ketika properti ditentukan dalam XAML, nilai dikonversi ke TimeSpan
dan divalidasi untuk memastikan bahwa jumlah milidetik lebih besar dari atau sama dengan 0, dan bahwa jumlah jam kurang dari 24. Komponen waktu harus dipisahkan oleh titik dua:
<TimePicker Time="4:15:26" />
BindingContext
Jika properti TimePicker diatur ke instans viewmodel yang berisi properti jenis TimeSpan
bernama SelectedTime
(misalnya), Anda dapat membuat instans TimePicker seperti ini:
<TimePicker Time="{Binding SelectedTime}" />
Dalam contoh ini, properti diinisialisasi Time
ke SelectedTime
properti di viewmodel. Time
Karena properti memiliki mode TwoWay
pengikatan , setiap kali baru yang dipilih pengguna secara otomatis disebarkan ke viewmodel.
Dalam kode, Anda dapat menginisialisasi Time
properti ke nilai jenis TimeSpan
:
TimePicker timePicker = new TimePicker
{
Time = new TimeSpan(4, 15, 26) // Time set to "04:15:26"
};
Untuk informasi tentang mengatur properti font, lihat Font.
TimePicker dan tata letak
Dimungkinkan untuk menggunakan opsi tata letak horizontal yang tidak dibatasi seperti Center
, , Start
atau End
dengan TimePicker:
<TimePicker ยทยทยท
HorizontalOptions="Center" />
Namun, ini tidak disarankan. Bergantung pada pengaturan Format
properti, waktu yang dipilih mungkin memerlukan lebar tampilan yang berbeda. Misalnya, string format "T" menyebabkan TimePicker tampilan menampilkan waktu dalam format panjang, dan "4:15:26 AM" memerlukan lebar tampilan yang lebih besar daripada format waktu singkat ("t") dari "4:15 AM". Tergantung pada platform, perbedaan ini dapat menyebabkan TimePicker tampilan berubah lebar dalam tata letak, atau agar tampilan terpotong.
Tip
Yang terbaik adalah menggunakan pengaturan default HorizontalOptions
dengan TimePicker, dan tidak menggunakan lebar Auto
saat meletakkan TimePicker dalam Grid sel.Fill
Perbedaan platform
Bagian ini menjelaskan perbedaan khusus platform dengan TimePicker kontrol.
Di Android, Format
properti dihormati dan ditampilkan oleh kontrol. Namun, ketika kontrol pemilih ditampilkan dengan menekan kontrol, hanya jam, menit, dan waktu hari yang dapat diubah.