Bagikan melalui

Timepicker

  • Artikel

.NET Multi-platform App UI (.NET MAUI) TimePicker memanggil kontrol pemilih waktu platform dan memungkinkan Anda untuk memilih waktu.

TimePicker menentukan properti berikut:

  • Time jenis TimeSpan, waktu yang dipilih, yang default ke TimeSpan 0. Jenis menunjukkan TimeSpan durasi waktu sejak tengah malam.
  • Format jenis string, 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 jenis FontAttributes, yang default ke FontAtributes.None.
  • FontFamily jenis string, yang default ke null.
  • FontSize jenis double, yang default ke -1.0.
  • CharacterSpacing, dari jenis double, 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.TwoWaypengikatan 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 .

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 TwoWaypengikatan , 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, , Startatau 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.