ProgressRing Класс

Определение

Пространство имен:

Microsoft.UI.Xaml.Controls

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

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

/// [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

Наследование

Control

ProgressRing

Атрибуты

MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

Примеры

Совет

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

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

Если они уже установлены, откройте их с помощью следующих ссылок: коллекция WinUI 3 или коллекция WinUI 2.

Если они не установлены, вы можете скачать коллекцию WinUI 3 и коллекцию WinUI 2 из Microsoft Store.

Исходный код можно также получить из GitHub (используйте главную ветвь для WinUI 3 и ветвь winui2 для WinUI 2).

Совет

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

Откройте приложение коллекции WinUI 2 и просмотрите ProgressRing в действии.

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

В этом примере показано, как задать свойство IsActive объекта ProgressRing в коде. ToggleSwitch используется для включения или выключения элемента управленияProgressRing.

<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>

В этом примере показано, как задать свойство IsIndeterminate в коде, чтобы показать заполнение кольца выполнения на основе свойства value.

<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;
   }
}

Комментарии

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

Используйте ProgressRing, чтобы визуально указать, что операция выполняется. Установите свойство IsActive , чтобы включить или отключить ProgressRing. Если isActive имеет значение false, progressRing не отображается, но для него зарезервировано место в макете пользовательского интерфейса. Чтобы не резервировать место для ProgressRing, задайте для свойства Visibility значение Collapsed.

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

• Установите для параметра IsIndeterminate значение true , чтобы отобразить повторяющуюся анимацию. (Это значение по умолчанию)
• Задайте для параметра 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 .

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

ProgressRing()

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

Свойства

IsActive	Возвращает или задает значение, указывающее, отображается ли progressRing в progressRing . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
IsActiveProperty	Определяет свойство зависимостей IsActive . Эта документация относится к 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 пространства имен).
Maximum	Возвращает или задает максимально допустимое значение элемента range. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
MaximumProperty	Определяет свойство Максимальное количество зависимостей. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
Minimum	Возвращает или задает минимально допустимое значение элемента range. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
MinimumProperty	Идентифицирует свойство минимальной зависимости. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TemplateSettings	Возвращает объект , предоставляющий вычисляемые значения, на которые можно ссылаться как на источники TemplateBinding при определении шаблонов для элемента управления ProgressRing . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
Value	Возвращает или задает текущую величину кольца выполнения. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
ValueProperty	Идентифицирует свойство зависимости Value . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

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

• ProgressBar
• Общие сведения об элементах управления хода выполнения
• Список элементов управления