ProgressBar

.NET 다중 플랫폼 앱 UI(.NET MAUI) ProgressBar 는 사용자에게 앱이 긴 작업을 통해 진행 중임을 나타냅니다. 진행률 표시줄은 값으로 표시되는 백분율로 채워진 가로 막대입니다 double .

플랫폼에 따라 달라지는 ProgressBar 모양이며, 다음 스크린샷은 Android의 모양을 ProgressBar 보여줍니다.

ProgressBar 는 다음 두 가지 속성을 정의합니다.

• Progress 는 double 현재 진행률을 0에서 1까지의 값으로 나타내는 값입니다. Progress 0보다 작은 값은 0으로 고정되고 1보다 큰 값은 1로 고정됩니다. 이 속성의 기본값은 0입니다.
• ProgressColor 는 의 Color 색을 정의하는 값입니다 ProgressBar.

이러한 속성은 BindableProperty 개체에서 지원하며, 따라서 데이터 바인딩의 대상이 될 수 있고 스타일이 지정될 수 있습니다.

ProgressBar 또한 현재 값에서 지정된 값으로 막대에 애니메이션 효과를 주는 메서드를 정의 ProgressTo 합니다. 자세한 내용은 ProgressBar 애니메이션 효과를 참조 하세요.

ProgressBar 만들기

긴 작업을 통해 진행률을 나타내려면 개체를 ProgressBar 만들고 해당 속성을 설정하여 모양을 정의합니다.

다음 XAML 예제에서는 다음을 표시하는 방법을 보여줍니다.ProgressBar

<ProgressBar Progress="0.5" />

해당하는 C# 코드는 다음과 같습니다.

ProgressBar progressBar = new ProgressBar { Progress = 0.5 };

Warning

제약이 없는 가로 레이아웃 옵션(예: Center, Start또는 End . ProgressBar)을 사용하지 마세요. 의 기본값 HorizontalOptions 을 유지합니다 Fill.

다음 XAML 예제에서는 색을 변경하는 방법을 보여줍니다.ProgressBar

<ProgressBar Progress="0.5"
             ProgressColor="Orange" />

해당하는 C# 코드는 다음과 같습니다.

ProgressBar progressBar = new ProgressBar
{
    Progress = 0.5,
    ProgressColor = Colors.Orange
};

ProgressBar에 애니메이션 효과 적용

메서드는 ProgressTo 현재 Progress 값에서 제공된 값에 시간이 지남에 따라 애니메이션 효과를 시킵니다ProgressBar. 이 메서드는 진행률 값, uint 기간(밀리초) 및 Easing 열거형 값을 허용 double 하고 .Task<bool> 다음 예제에서는 애니메이션 효과를 주는 방법을 보여 줍니다.ProgressBar

// animate to 75% progress over 500 milliseconds with linear easing
await progressBar.ProgressTo(0.75, 500, Easing.Linear);

열거형에 Easing 대한 자세한 내용은 감속/가속 함수를 참조 하세요.