ProgressBar Kelas

Definisi

Ruang nama:

Microsoft.UI.Xaml.Controls

Mewakili kontrol yang menunjukkan kemajuan operasi.

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 ProgressBar : RangeBase

[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 ProgressBar : RangeBase

Public Class ProgressBar
Inherits RangeBase

Warisan

RangeBase

ProgressBar

Atribut

MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

Contoh

Tip

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

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

Berikut ini memperlihatkan cara menyiapkan ProgressBar yang tidak ditentukan dan ProgressBar penentuan dasar di mana nilai bergantung pada klik RepeatButton.

<!-- xmlns:muxc="using:Microsoft.UI.Xaml.Controls" -->

<StackPanel x:Name="LayoutRoot">
    <StackPanel BorderThickness="4" BorderBrush="Black" Padding="12">
        <TextBlock Text="Indeterminate Progress Bar"/>
        <muxc:ProgressBar IsIndeterminate="True" Margin="0,12"/>
    </StackPanel>
    <StackPanel BorderBrush="Black" BorderThickness="4" Padding="12">
        <TextBlock Text="Value-Based Progress Bar"/>
        <muxc:ProgressBar x:Name="progressBar1" Value="0" Maximum="200" Margin="0,12"/>
        <RepeatButton Content="Press and hold" Click="RepeatButton_Click"/>
    </StackPanel>
</StackPanel>

private static int _clicks = 0;

private void RepeatButton_Click(object sender, RoutedEventArgs e)
{
    _clicks += 1;
    progressBar1.Value = _clicks;
    if (_clicks >= progressBar1.Maximum) _clicks = 0;
}

Keterangan

Kontrol ProgressBar secara visual menunjukkan kemajuan operasi dengan salah satu dari dua gaya: bilah yang menampilkan pola berulang, atau bilah yang terisi berdasarkan nilai.

Properti IsIndeterminate menentukan tampilan ProgressBar.

• Atur IsIndeterminate ke true untuk menampilkan pola berulang. Kontrol alternatif yang digunakan untuk kemajuan yang tidak ditentukan adalah ProgressRing.
• Atur IsIndeterminate ke false untuk mengisi bilah berdasarkan nilai. (Ini adalah default.) 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

ProgressBar()

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

Properti

IsIndeterminate	Mendapatkan atau menetapkan nilai yang menunjukkan apakah bilah 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).
ShowError	Mendapatkan atau menetapkan nilai yang menunjukkan apakah bilah kemajuan harus menggunakan status visual yang mengkomunikasikan status Kesalahan kepada pengguna. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
ShowErrorProperty	Mengidentifikasi properti dependensi ShowError . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
ShowPaused	Mendapatkan atau menetapkan nilai yang menunjukkan apakah bilah kemajuan harus menggunakan status visual yang mengomunikasikan status Dijeda kepada pengguna. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
ShowPausedProperty	Mengidentifikasi properti dependensi ShowPaused . 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 ProgressBar . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).

Lihat juga

• ProgressRing
• Kontrol kemajuan