Поделиться через


ProgressBar Класс

Определение

Представляет элемент управления, указывающий ход выполнения операции.

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
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(Microsoft.UI.Xaml.XamlContract, 65536)]
class ProgressBar : RangeBase
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
public 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
Наследование
ProgressBar
Атрибуты
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContractVersionAttribute

Примеры

Совет

Дополнительные сведения, рекомендации по проектированию и примеры кода см. в разделе Элементы управления ход выполнения.

Приложения из коллекции WinUI 2 включают интерактивные примеры большинства элементов управления, возможностей и функций WinUI 2. Получите приложение из Microsoft Store или получите исходный код в GitHub.

Ниже показано, как настроить неопределенный элемент ProgressBar и базовый детерминированный ProgressBar, где значение зависит от щелчка 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;
}

Комментарии

Элемент управления ProgressBar визуально показывает ход выполнения операции одним из двух стилей: панель, отображающая повторяющийся шаблон, или полоса, заполняющая на основе значения.

Неопределенные и определенные элементы управления индикатором выполнения

Свойство IsIndeterminate определяет внешний вид ProgressBar.

  • Установите для параметра IsIndeterminateзначение true , чтобы отобразить повторяющийся шаблон. Альтернативным элементом управления для неопределенного хода выполнения является ProgressRing.
  • Установите для параметра IsIndeterminateзначение false , чтобы заполнить строку на основе значения. (Это значение по умолчанию.) Если isIndeterminate имеет значение false, диапазон указывается с помощью свойств Минимум и Максимум . По умолчанию минимальное значение равно 0, а максимальное — 100. Чтобы указать значение хода выполнения, необходимо задать свойство Value .

Стиль и шаблон элемента управления

Вы можете изменить стандартные параметры Style и ControlTemplate , чтобы придать элементу управления уникальный внешний вид. Сведения об изменении стиля и шаблона элемента управления см. в статье Стили XAML. Стиль по умолчанию, шаблон и ресурсы, определяющие внешний вид элемента управления, включаются в generic.xaml файл . В целях generic.xaml проектирования устанавливается вместе с пакетом NuGet WinUI (Microsoft.UI.Xaml). По умолчанию, это расположение \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Стили и ресурсы из разных версий WinUI могут иметь разные значения.

XAML также включает ресурсы, которые можно использовать для изменения цветов элемента управления в различных визуальных состояниях без изменения шаблона элемента управления. Изменение этих ресурсов предпочтительнее, чем установка таких свойств, как Background и Foreground. Дополнительные сведения см. в разделе Облегчаемые стили статьио стилях XAML .

Конструкторы

ProgressBar()

Инициализирует новый экземпляр класса ProgressBar .

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

Свойства

IsIndeterminate

Возвращает или задает значение, указывающее, сообщает ли индикатор выполнения универсальный ход выполнения с повторяющимся шаблоном, или сообщает о ходе выполнения на основе свойства Value .

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

IsIndeterminateProperty

Определяет свойство зависимости IsIndeterminate .

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

ShowError

Возвращает или задает значение, указывающее, должен ли индикатор выполнения использовать визуальные состояния, сообщающие пользователю о состоянии ошибки .

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

ShowErrorProperty

Определяет свойство зависимости ShowError .

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

ShowPaused

Возвращает или задает значение, указывающее, должен ли индикатор выполнения использовать визуальные состояния, сообщающие пользователю о приостановленном состоянии.

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

ShowPausedProperty

Определяет свойство зависимостей ShowPaused .

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

TemplateSettings

Возвращает объект , предоставляющий вычисляемые значения, на которые можно ссылаться как на источники TemplateBinding при определении шаблонов для элемента управления ProgressBar .

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

TemplateSettingsProperty

Определяет свойство зависимости TemplateSettings .

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

Применяется к

См. также раздел