ProgressIndicator 제어

아티클
03/21/2023

로딩 환경을 만드는 데 사용되는 컨트롤입니다.

노트

GitHub 코드 구성 요소 리포지토리에서 전체 설명서 및 소스 코드를 확인할 수 있습니다.

ProgressIndicator 컨트롤.

Description

진행 표시기는 2초 이상 지속되는 작업의 완료 상태를 표시하는 데 사용됩니다. 진행 상태를 확인할 수 없는 경우 Spinner를 사용하거나 Indeterminate Indicator 유형을 대신 사용하십시오. 작업을 취소하거나 중지하는 경우 UI가 반환될 수 있는 한 진행률 표시기는 새 패널, 플라이아웃 창, 작업을 시작한 UI 아래에 나타나거나 시작 UI를 교체할 수도 있습니다.

이 코드 구성 요소는 캔버스 및 사용자 지정 페이지에서 사용하기 위해 유창한 UI ProgressIndicator 컨트롤 주위에 래퍼를 제공합니다. 모범 사례는 구성 요소 설명서를 참조하십시오.

속성

키 속성

Property	Description
`Label`	스피너에 대한 선택적 레이블입니다.
`Percentage Complete`	완료된 작업의 백분율로, 0에서 1 사이의 척도입니다. 설정하지 않으면 불확정 지표가 표시됩니다.
`TypeOfIndicator`	지표 스타일의 유형을 지정합니다. 선택 사항: `Default Indicator` 또는 `IndeterminateIndicator`
`HideProgressState`	진행 상태를 숨기려면 true를 지정하십시오
`BarHeight`	해당하는 막대의 높이를 지정하십시오

스타일 속성

Property	Description
`Theme`	유창한 UI 테마 디자이너(windows.net)를 사용하여 생성된 JSON 문자열을 허용합니다. 이 항목을 비워 두면 Power Apps에서 정의한 기본 테마가 사용됩니다. 설정 방법은 테마 설정을 참고하세요.
`AccessibilityLabel`	화면 읽기 프로그램 아리아-레이블

동작

로딩 진행률 표시

프로세스가 시작될 때 ProgressIndicator 컨트롤 자체(또는 컨트롤이 위치한 표면)를 표시한 다음, 프로세스의 세그먼트가 완료되면 값으로 변수를 업데이트합니다. 프로세스가 완료되면 숨깁니다. 변수를 사용하여 컨트롤의 가시성을 제어하고 표시해야 하는 프로세스의 주요 코드 블록 사이의 값을 업데이트합니다.

UpdateContext({ var_showProgress: true , var_progressValue: 0 });

/* Some code ... */

UpdateContext({ var_progressValue: 25 });

/* Some code ... */

UpdateContext({ var_progressValue: 50 });

/* Some code ... */

UpdateContext({ var_progressValue: 75 });

/* Some code ... */

UpdateContext({ var_progressValue: 100 });

Notify("Successfully completed process", NotificationType.Success);

UpdateContext({ var_showProgress: false });

ProgressIndicator(또는 이를 포함하는 표면)의 Visible 속성 값으로 var_showProgress 변수를 제공하고 Value 속성에 대해 var_progressValue 변수를 할당합니다.

제한 사항

이 캔버스 구성 요소는 캔버스 앱 및 사용자 정의 페이지에서만 사용할 수 있습니다.

다음을 통해 공유