Xamarin.Forms ProgressBar

  • 아티클

Download Sample 샘플 다운로드

컨트롤은 Xamarin.FormsProgressBar 값을 나타내는 백분율로 채워진 가로 막대로 진행률을 시각적으로 float 나타냅니다. 클래스는 ProgressBar .에서 View상속됩니다.

다음 스크린샷은 iOS 및 Android의 ProgressBar를 보여줍니다.

Screenshot of ProgressBar on iOS and Android

컨트롤은 ProgressBar 다음 두 가지 속성을 정의합니다.

  • Progress 는 float 현재 진행률을 0에서 1까지의 값으로 나타내는 값입니다. Progress 0보다 작은 값은 0으로 고정되고 1보다 큰 값은 1로 고정됩니다.
  • ProgressColorColor 는 현재 진행률을 나타내는 내부 막대 색에 영향을 주는 값입니다.

이러한 속성은 개체 ProgressBar 에 의해 BindableProperty 지원되므로 스타일이 지정되고 데이터 바인딩의 대상이 될 수 있습니다.

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

참고 항목

사용자 조작은 ProgressBar 허용되지 않으므로 Tab 키를 사용하여 컨트롤을 선택할 때 건너뜁니다.

ProgressBar 만들기

A는 ProgressBar XAML에서 인스턴스화할 수 있습니다. 해당 Progress 속성은 안쪽의 색이 지정된 막대의 채우기 비율을 결정합니다. 기본 Progress 속성 값은 0입니다. 다음 예제에서는 선택적 Progress 속성 집합을 사용하여 ProgressBar XAML에서 인스턴스화하는 방법을 보여줍니다.

<ProgressBar Progress="0.5" />

코드에서 A ProgressBar 를 만들 수도 있습니다.

ProgressBar progressBar = new ProgressBar { Progress = 0.5f };

Warning

제약이 없는 가로 레이아웃 옵션(예: Center, Start또는 End . ProgressBar)을 사용하지 마세요. UWP에서는 너비가 ProgressBar 0인 막대로 축소됩니다. 레이아웃에 넣을 때의 기본값 HorizontalOptionsFill 을 유지하고 너비 Auto 를 ProgressBarGrid 사용하지 마세요.

ProgressBar 모양 속성

속성이 ProgressColor 0보다 큰 경우 속성은 내부 막대 색을 Progress 정의합니다. 다음 예제에서는 속성 집합을 사용하여 ProgressBar XAML ProgressColor 에서 인스턴스화하는 방법을 보여줍니다.

<ProgressBar ProgressColor="Orange" />

코드를 만들 때 속성을 ProgressColor 설정할 수도 있습니다.ProgressBar

ProgressBar progressBar = new ProgressBar { ProgressColor = Color.Orange };

다음 스크린샷은 iOS 및 Android에서 ProgressColor 설정된 속성을 Color.Orange 보여 ProgressBar 줍니다.

Screenshot of styled ProgressBar on iOS and Android

ProgressBar에 애니메이션 효과 적용

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

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

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