ProgressRing Kelas

Definisi

Ruang nama:

Microsoft.UI.Xaml.Controls

Mewakili kontrol yang menunjukkan kemajuan operasi. Tampilan visual yang khas adalah "spinner" berbentuk cincin.

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 ProgressRing : 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 ProgressRing : Control

Public Class ProgressRing
Inherits Control

Warisan

Control

ProgressRing

Atribut

MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

Contoh

Tip

Untuk informasi selengkapnya, panduan desain, dan contoh kode, lihat Kontrol kemajuan.

Aplikasi Galeri WinUI 3 dan Galeri WinUI 2 mencakup contoh interaktif sebagian besar kontrol, fitur, dan fungsi WinUI 3 dan WinUI 2.

Jika sudah diinstal, buka dengan mengklik tautan berikut: Galeri WinUI 3 atau Galeri WinUI 2.

Jika tidak diinstal, Anda dapat mengunduh Galeri WinUI 3 dan Galeri WinUI 2 dari Microsoft Store.

Anda juga bisa mendapatkan kode sumber untuk keduanya dari GitHub (gunakan cabang utama untuk WinUI 3 dan cabang winui2 untuk WinUI 2).

Tip

Untuk informasi selengkapnya, panduan desain, dan contoh kode, lihat Kontrol kemajuan.

Buka aplikasi Galeri WinUI 2 dan lihat ProgressRing yang sedang 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.

Contoh ini memperlihatkan cara mengatur properti IsActive dari ProgressRing dalam kode. ToggleSwitch digunakan untuk mengaktifkan atau menonaktifkan kontrolProgressRing.

<StackPanel>
   <muxc:ProgressRing IsActive="{x:Bind ProgressToggle.IsOn, Mode=OneWay}" />
   <ToggleSwitch x:Name="ProgressToggle" Header="Toggle work" OffContent="Do work" OnContent="Working" IsOn="True" />
</StackPanel>

Contoh ini menunjukkan cara mengatur properti IsIndeterminate dalam kode untuk memperlihatkan pengisian cincin kemajuan berdasarkan properti nilai.

<StackPanel>
   <muxc:ProgressRing IsIndeterminate="false">
   <muxc:NumberBox x:Name="ProgressValue" Minimum="0" Maximum="100" SpinButtonPlacementMode="Inline" ValueChanged="ProgressValue_ValueChanged"/>
</StackPanel>

 private void ProgressValue_ValueChanged(Microsoft.UI.Xaml.Controls.NumberBox sender, Microsoft.UI.Xaml.Controls.NumberBoxValueChangedEventArgs args)
{
   if (!sender.Value.IsNaN())
   {
         ProgressRing2.Value = sender.Value;
   }
   else
   {
         sender.Value = 0;
   }
}

Keterangan

ProgressRing adalah kontrol yang secara visual menunjukkan kemajuan operasi dengan salah satu dari dua gaya: cincin yang berulang kali menganimasikan, atau cincin yang terisi berdasarkan nilai.

Gunakan ProgressRing untuk menunjukkan bahwa operasi sedang berlangsung secara visual. Atur properti IsActive untuk mengaktifkan atau menonaktifkan ProgressRing. Jika IsActive salah, ProgressRing tidak ditampilkan, tetapi ruang dicadangkan untuk itu di tata letak UI. Untuk tidak mencadangkan ruang untuk ProgressRing, atur properti Visibilitasnya ke Diciutkan.

Properti IsIndeterminate menentukan tampilan ProgressRing.

• Atur IsIndeterminate ke true untuk menampilkan animasi berulang. (Ini adalah default)
• Atur IsIndeterminate ke false untuk mengisi bilah berdasarkan nilai. Ketika IsIndeterminatesalah, Anda menentukan rentang dengan properti Minimum dan Maksimum . Secara default Minimum adalah 0 dan Maksimum adalah 100. Untuk menentukan nilai kemajuan, Anda mengatur properti Nilai .

Gaya kontrol dan templat

Anda dapat mengubah Gaya dan ControlTemplate default untuk memberi kontrol tampilan yang unik. 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

ProgressRing()

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

Properti

IsActive	Mendapatkan atau menetapkan nilai yang menunjukkan apakah ProgressRing menunjukkan kemajuan. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
IsActiveProperty	Mengidentifikasi properti dependensi IsActive . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
IsIndeterminate	Mendapatkan atau menetapkan nilai yang menunjukkan apakah cincin kemajuan melaporkan kemajuan umum dengan pola berulang atau melaporkan kemajuan berdasarkan properti Nilai . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
IsIndeterminateProperty	Mengidentifikasi properti dependensi IsIndeterminate . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
Maximum	Mendapatkan atau mengatur Nilai tertinggi yang diizinkan dari elemen rentang. 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 Nilai minimum yang diizinkan dari elemen rentang. 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).
TemplateSettings	Mendapatkan objek yang menyediakan nilai terhitung yang dapat direferensikan sebagai sumber TemplateBinding saat menentukan templat untuk kontrol ProgressRing . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
Value	Mendapatkan atau mengatur besaran cincin kemajuan saat ini. 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).

Lihat juga

• ProgressBar
• Gambaran umum kontrol kemajuan
• Daftar kontrol