NumberBox Kelas

Definisi

Ruang nama:

Microsoft.UI.Xaml.Controls

Mewakili kontrol yang dapat digunakan untuk menampilkan dan mengedit angka.

Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class NumberBox : Control

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class NumberBox : Control

Public Class NumberBox
Inherits Control

Warisan

Control

NumberBox

Atribut

MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

Contoh

Tip

Untuk informasi selengkapnya, panduan desain, dan contoh kode, lihat Kotak nomor.

Buka aplikasi Galeri WinUI 2 dan lihat NumberBox beraksi.

Aplikasi WinUI 2 Gallery mencakup contoh interaktif sebagian besar kontrol, fitur, dan fungsi WinUI 2. Dapatkan aplikasi dari Microsoft Store atau dapatkan kode sumber di GitHub.

Keterangan

Kontrol ini mendukung validasi, tahapan tahapan, dan perhitungan sebaris komputasi persamaan dasar seperti perkalian, pembagian, penambahan, dan pengurangan.

Gaya kontrol dan templat

Anda dapat mengubah Gaya dan ControlTemplate default untuk memberikan tampilan unik pada kontrol. Untuk informasi tentang memodifikasi gaya dan templat kontrol, lihat gaya XAML. Gaya, templat, dan sumber daya default yang menentukan tampilan kontrol disertakan dalam generic.xaml file. Untuk tujuan desain, generic.xaml diinstal dengan paket NuGet WinUI (Microsoft.UI.Xaml). Secara default, lokasi ini adalah \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Gaya dan sumber daya dari versi WinUI yang berbeda mungkin memiliki nilai yang berbeda.

XAML juga menyertakan sumber daya yang dapat Anda gunakan untuk memodifikasi warna kontrol dalam status visual yang berbeda tanpa memodifikasi templat kontrol. Memodifikasi sumber daya ini lebih disukai untuk mengatur properti seperti Latar Belakang dan Latar Depan. Untuk informasi selengkapnya, lihat bagian Gaya ringan dari artikel gaya XAML .

Konstruktor

NumberBox()

Menginisialisasi instans baru kelas NumberBox . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).

Properti

AcceptsExpression	Mengalihkan apakah kontrol akan menerima dan mengevaluasi ekspresi rumus dasar yang dimasukkan sebagai input. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
AcceptsExpressionProperty	Mengidentifikasi properti dependensi AcceptsExpression . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
Description	Mendapatkan atau mengatur konten yang ditunjukkan di bawah kontrol. Konten harus memberikan panduan tentang input yang diharapkan oleh kontrol. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
DescriptionProperty	Mengidentifikasi properti dependensi Deskripsi . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
Header	Mendapatkan atau mengatur konten untuk header kontrol. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
HeaderProperty	Mengidentifikasi properti dependensi Header . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
HeaderTemplate	Mendapatkan atau mengatur DataTemplate yang digunakan untuk menampilkan konten header kontrol. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
HeaderTemplateProperty	Mengidentifikasi properti dependensi HeaderTemplate . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
IsWrapEnabled	Mengalihkan apakah pemisah baris terjadi jika baris teks meluas melampaui lebar kontrol yang tersedia. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
IsWrapEnabledProperty	Mengidentifikasi properti dependensi IsWrapEnabled . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
LargeChange	Mendapatkan atau mengatur nilai yang ditambahkan ke atau dikurangi dari Nilai saat perubahan besar dilakukan, seperti dengan kunci PageUP dan PageDown. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
LargeChangeProperty	Mengidentifikasi properti dependensi LargeChange . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
Maximum	Mendapatkan atau mengatur maksimum numerik untuk Nilai. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
MaximumProperty	Mengidentifikasi properti Dependensi maksimum . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
Minimum	Mendapatkan atau mengatur minimum numerik untuk Nilai. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
MinimumProperty	Mengidentifikasi properti Dependensi minimum . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
NumberFormatter	Mendapatkan atau mengatur objek yang digunakan untuk menentukan pemformatan Nilai. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
NumberFormatterProperty	Mengidentifikasi properti dependensi NumberFormatter . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
PlaceholderText	Mendapatkan atau mengatur teks yang ditampilkan dalam kontrol hingga nilai diubah oleh tindakan pengguna atau beberapa operasi lainnya. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
PlaceholderTextProperty	Mengidentifikasi properti dependensi PlaceholderText . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
PreventKeyboardDisplayOnProgrammaticFocus	Mendapatkan atau mengatur nilai yang menunjukkan apakah keyboard di layar ditampilkan saat kontrol menerima fokus secara terprogram. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
PreventKeyboardDisplayOnProgrammaticFocusProperty	Mengidentifikasi properti dependensi PreventKeyboardDisplayOnProgrammaticFocus . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
SelectionFlyout	Mendapatkan atau mengatur flyout yang ditampilkan saat teks dipilih, atau null jika tidak ada flyout yang ditampilkan. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
SelectionFlyoutProperty	Mengidentifikasi properti dependensi SelectionFlyout . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
SelectionHighlightColor	Mendapatkan atau mengatur kuas yang digunakan untuk menyoroti teks yang dipilih. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
SelectionHighlightColorProperty	Mengidentifikasi properti dependensi SelectionHighlightColor . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
SmallChange	Mendapatkan atau mengatur nilai yang ditambahkan ke atau dikurangi dari Nilai saat perubahan kecil dilakukan, seperti dengan tombol panah atau menggulir. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
SmallChangeProperty	Mengidentifikasi properti dependensi SmallChange . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
SpinButtonPlacementMode	Mendapatkan atau menetapkan nilai yang menunjukkan penempatan tombol yang digunakan untuk menambah atau mengurangi properti Nilai . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
SpinButtonPlacementModeProperty	Mengidentifikasi properti dependensi SpinButtonPlacementMode . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
Text	Mendapatkan atau mengatur representasi jenis string properti Nilai . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TextProperty	Mengidentifikasi properti dependensi Teks . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TextReadingOrder	Mendapatkan atau menetapkan nilai yang menunjukkan bagaimana urutan pembacaan ditentukan untuk NumberBox. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TextReadingOrderProperty	Mengidentifikasi properti dependensi TextReadingOrder . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
ValidationMode	Mendapatkan atau mengatur perilaku validasi input yang akan dipanggil saat input yang tidak valid dimasukkan. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
ValidationModeProperty	Mengidentifikasi properti dependensi ValidationMode . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
Value	Mendapatkan atau mengatur nilai numerik Dari NumberBox. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
ValueProperty	Mengidentifikasi properti dependensi Nilai . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).

Acara

ValueChanged

Terjadi setelah pengguna memicu evaluasi input baru dengan menekan tombol Enter, mengklik tombol putar, atau dengan mengubah fokus. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).

Lihat juga

• NumberBoxSpinButtonPlacementMode
• NumberBoxValidationMode
• NumberBoxValueChangedEventArgs