ProgressRing 클래스

정의

네임스페이스:

Microsoft.UI.Xaml.Controls

작업의 진행률을 나타내는 컨트롤을 나타냅니다. 일반적인 시각적 모양은 링 모양의 "스피너"입니다.

이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 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 갤러리 링크를 클릭하여 갤러리를 엽니다.

설치되지 않은 경우 Microsoft Store에서 WinUI 3 갤러리 및 WinUI 2 갤러리를 다운로드할 수 있습니다.

GitHub에서 두 갤러리의 소스 코드를 가져올 수도 있습니다(WinUI 3는 main 분기, WinUI 2는 winui2 분기 사용).

팁

자세한 정보, 디자인 지침 및 코드 예제는 진행률 컨트롤을 참조하세요.

WinUI 2 갤러리 앱을 열고 ProgressRing 작동을 확인합니다.

WinUI 2 갤러리 앱에는 대부분의 WinUI 2 컨트롤, 특징, 기능의 대화형 예제가 포함되어 있습니다. Microsoft Store에서 앱을 다운로드하거나 GitHub에서 소스 코드를 가져오세요.

이 예제에서는 코드에서 ProgressRing의 IsActive 속성을 설정하는 방법을 보여줍니다. 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 속성을 설정하는 방법을 보여줍니다.

<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을 사용하여 작업이 진행 중임을 시각적으로 나타냅니다. ProgressRing을 켜거나 끄려면 IsActive 속성을 설정합니다. IsActive가 false이면 ProgressRing이 표시되지 않지만 UI 레이아웃에서 공백이 예약됩니다. ProgressRing에 대한 공간을 예약하지 않하려면 Visibility 속성을 Collapsed로 설정합니다.

IsIndeterminate 속성은 ProgressRing의 모양을 결정합니다.

• 반복 애니메이션을 표시하려면 IsIndeterminate 를 true 로 설정합니다. (기본값)
• 값을 기준으로 막대를 채우려면 IsIndeterminate 를 false 로 설정합니다. IsIndeterminate가 false이면 최소 및 최대 속성을 사용하여 범위를 지정합니다. 기본적으로 최소값 은 0이고 최대 값은 100입니다. 진행률 값을 지정하려면 Value 속성을 설정합니다.

컨트롤 스타일 및 템플릿

기본 스타일 및 ControlTemplate 을 수정하여 컨트롤에 고유한 모양을 지정할 수 있습니다. 컨트롤의 스타일 및 템플릿을 수정하는 방법에 대한 자세한 내용은 XAML 스타일을 참조하세요. 컨트롤의 모양을 정의하는 기본 스타일, 템플릿 및 리소스가 파일에 포함 generic.xaml 됩니다. 디자인 목적으로 는 generic.xaml WinUI(Microsoft.UI.Xaml) NuGet 패키지와 함께 설치됩니다. 기본적으로 이 위치는 \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml입니다. 다른 버전의 WinUI의 스타일 및 리소스에는 다른 값이 있을 수 있습니다.

XAML에는 컨트롤 템플릿을 수정하지 않고 다른 시각적 상태에서 컨트롤의 색을 수정하는 데 사용할 수 있는 리소스도 포함되어 있습니다. 이러한 리소스를 수정하는 것은 Background 및 Foreground와 같은 속성을 설정하는 것이 좋습니다. 자세한 내용은 XAML 스타일 문서의 경량 스타일 섹션을 참조하세요.

생성자

ProgressRing()

ProgressRing 클래스의 새 instance 초기화합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

속성

IsActive	ProgressRing에 진행률이 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
IsActiveProperty	IsActive 종속성 속성을 식별합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
IsIndeterminate	진행률 링이 반복 패턴으로 일반 진행률을 보고하는지 또는 Value 속성을 기반으로 진행률을 보고하는지 여부를 나타내는 값을 가져오거나 설정합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
IsIndeterminateProperty	IsIndeterminate 종속성 속성을 식별합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
Maximum	범위 요소의 허용되는 가장 높은 값을 가져오거나 설정합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
MaximumProperty	최대 종속성 속성을 식별합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
Minimum	범위 요소의 허용되는 최소 값을 가져오거나 설정합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
MinimumProperty	최소 종속성 속성을 식별합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
TemplateSettings	ProgressRing 컨트롤에 대한 템플릿을 정의할 때 TemplateBinding 원본으로 참조할 수 있는 계산 값을 제공하는 개체를 가져옵니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
Value	진행률 링의 현재 크기를 가져오거나 설정합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ValueProperty	Value 종속성 속성을 식별합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

추가 정보

• ProgressBar
• 진행률 컨트롤 개요
• 컨트롤 목록