XAML - ProgressRing

更新于 2024/6/13 10:56:00

ProgressRing 是一种指示正在进行的操作的控件。典型的视觉外观是一个环形"旋转器"，随着进度的继续，它会循环播放动画。这里重要的一点是 WPF 项目不支持 ProgressRing。因此，对于此控件，我们将在 Windows Store App 上工作。 ProgressRing 类的层次继承如下 −

属性

下面给出了 ProgressRing 的常用属性。

Sr.No.	属性 &描述
1	IsActive 获取或设置一个值，该值指示 ProgressRing 是否显示进度。
2	IsActiveProperty 标识 IsActive 依赖项属性。
3	TemplateSettings 获取一个对象，该对象提供计算值，可在为 ProgressRing 控件定义模板时将其引用为 TemplateBinding 源。

Sr.No.

属性 &描述

IsActive

获取或设置一个值，该值指示 ProgressRing 是否显示进度。

IsActiveProperty

标识 IsActive 依赖项属性。

TemplateSettings

获取一个对象，该对象提供计算值，可在为 ProgressRing 控件定义模板时将其引用为 TemplateBinding 源。

事件

下面给出了 ProgressRing 类中常用的事件。

Sr.No.	事件和说明
1	ManipulationCompleted 当 UIElement 上的操作完成时发生。（从 UIElement 继承）
2	ManipulationDelta 当输入设备在操作过程中改变位置时发生。（从 UIElement 继承）
3	ManipulationInertiaStarting 当输入设备在操作过程中与 UIElement 对象失去联系并且开始惯性时发生。（从 UIElement 继承）
4	ManipulationStarted 当输入设备开始对 UIElement 进行操作时发生。（从 UIElement 继承）
5	ManipulationStarting 首次创建操作处理器时发生。（从 UIElement 继承）
6	ValueChanged 范围值更改时发生。（从 RangeBase 继承）

方法

下面给出了 ProgressRing 类中常用的方法。

Sr.No.	方法 &描述
1	OnManipulationCompleted 在 ManipulationCompleted 事件发生之前调用。（从控件继承）
2	OnManipulationDelta 在 ManipulationDelta 事件发生之前调用。（从控件继承）
3	OnManipulationInertiaStarting 在 ManipulationInertiaStarting 事件发生之前调用。（从控件继承）
4	OnManipulationStarted 在 ManipulationStarted 事件发生之前调用。（从控件继承）
5	OnManipulationStarting 在 ManipulationStarting 事件发生之前调用。（从控件继承）
6	OnMaximumChanged 在 Maximum 属性更改时调用。（从 RangeBase 继承）
7	OnMinimumChanged 当 Minimum 属性发生变化时调用。（从 RangeBase 继承）

示例

以下示例显示如何将 ProgressRing 与 ToggleSwitch 结合使用。以下是 XAML 中的代码，用于创建和初始化 ProgressRing 和 ToggleSwitch −

<Page x:Class = "ProgressRing.MainPage" 
   xmlns = "http://schemas.microsoft.com/winfx/2006/xaml/presentation"
   xmlns:x = "http://schemas.microsoft.com/winfx/2006/xaml" 
   xmlns:local = "using:ProgressRing" 
   xmlns:d = "http://schemas.microsoft.com/expression/blend/2008" 
   xmlns:mc = "http://schemas.openxmlformats.org/markup-compatibility/2006" 
   mc:Ignorable = "d">
	
   <Grid Background = "{ThemeResource ApplicationPageBackgroundThemeBrush}"> 
      <StackPanel Orientation = "Horizontal" Margin = "342,0,-342,0"> 
         <ProgressRing x:Name = "progress1"/> 
         <ToggleSwitch Header = "ProgressRing Example" OffContent = "Do work"
            OnContent = "Working" Toggled = "ToggleSwitch_Toggled" 
            Margin = "0,348,0,347"/> 
      </StackPanel>
   </Grid> 
	
</Page>

下面是 Toggled 事件的 C# 实现 −

using System; 
using System.Runtime.InteropServices.WindowsRuntime; 
using Windows.Foundation; 
using Windows.Foundation.Collections; 
using Windows.UI.Xaml; 
using Windows.UI.Xaml.Controls; 
using Windows.UI.Xaml.Controls.Primitives;
 
namespace ProgressRing { 
   public sealed partial class MainPage : Page {
      public MainPage() {
         this.InitializeComponent(); 
      } 
      private void ToggleSwitch_Toggled(object sender, RoutedEventArgs e) { 
         ToggleSwitch toggleSwitch = sender as ToggleSwitch; 
			
         if (toggleSwitch != null) { 
            if (toggleSwitch.IsOn == true) { 
               progress1.IsActive = true; 
               progress1.Visibility = Visibility.Visible; 
            } else {
               progress1.IsActive = false; 
               progress1.Visibility = Visibility.Collapsed; 
            }
         }
      }
   }
}

当您编译并执行上述代码时，它会产生以下输出 −