Control ProgressIndicator

Control utilitzat per crear una experiència de càrrega.

Nota

Trobareu la documentació completa i el codi font al dipòsit de components de codi de GitHub.

Descripció

Els indicadors de progrés s'utilitzen per mostrar l'estat de finalització d'una operació que dura més de dos segons. Si l'estat de progrés no es pot determinar, utilitzeu un Spinner o utilitzeu el tipus Indeterminate Indicator. Els indicadors de progrés poden aparèixer en una subfinestra nova, en una finestra desplegable, a la IU que ha iniciat l'operació, o fins i tot poden substituir la IU d'inici sempre que la IU pugui tornar si cancel·leu o atureu l'activitat.

Aquest component de codi proporciona un embolcall al voltant del control Fluent UI ProgressIndicator per utilitzar-lo en llenços i pàgines personalitzades. Vegeu la documentació del component per veure pràctiques recomanades.

Propietats

Propietats de la clau

Propietat	Descripció
Label	Etiqueta opcional per a spinner.
Percentage Complete	Percentatge de l'operació completat, en l'escala del 0 a l'1. Si no s'ha definit es mostrarà l'Indicador indeterminat.
TypeOfIndicator	Especifica el tipus d'estil de l'indicador. Opcions: Default Indicator o IndeterminateIndicator
HideProgressState	Especifiqueu cert per amagar l'estat de progrés
BarHeight	Especifiqueu l'alçada de la barra segons calgui

Propietats d'estil

Propietat	Descripció
Theme	Accepta una cadena JSON generada mitjançant el Fluent UI Theme Designer (windows.net). Deixant aquest camp en blanc s'utilitzarà el tema per defecte definit per Power Apps. Per obtenir ajuda sobre com s'ha de configurar, vegeu temes.
AccessibilityLabel	Etiqueta aria de lector de pantalla

Comportament

Mostra el progrés de la càrrega

Feu que el control ProgressIndicator en si mateix (o la superfície en què està ubicat) estigui visible quan comenci un procés, després actualitzeu una variable amb el valor a mesura que es completin els segments del procés. Amagueu-lo quan el procés s'hagi completat. Utilitzeu una variable per controlar la visibilitat del control i actualitzar els valors entre els blocs de codi principals del procés que s'ha d'indicar.

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 });

Proporcioneu la variable var_showProgress com a valor per a la propietat Visible de ProgressIndicator (o la superfície que la conté) i assigneu la variable var_progressValue per a la propietat Value.

Limitacions

Aquest component del llenç només es pot utilitzar a les aplicacions del llenç i a les pàgines personalitzades.