ProgressIndicator controlar

Artigo
03/21/2023

Controle usado para criar uma experiência de carregamento.

Nota

Documentação completa e código-fonte encontrados no repositório de componentes de código GitHub.

Controle ProgressIndicator.

Description

Os indicadores de progresso são usados para mostrar o status de conclusão de uma operação com duração superior a dois segundos. Se o estado de progresso não puder ser determinado, use um Spinner ou use o tipo Indeterminate Indicator. Os indicadores de progresso podem aparecer em um novo painel, em uma janela desdobrável, sob a interface do usuário que iniciou a operação ou podem até substituir a interface do usuário inicial, desde que a interface do usuário possa retornar se você cancelar ou interromper a atividade.

Este componente de código fornece um wrapper em torno do controle Fluent UI ProgressIndicator para uso em telas e páginas personalizadas. Consulte a documentação do componente para obter as melhores práticas.

Propriedades

Principais propriedades

Propriedade	Description
`Label`	Etiqueta opcional para spinner.
`Percentage Complete`	Percentual da operação concluída, na escala de 0 a 1. Se não estiver definido, o Indicador Indeterminado será mostrado.
`TypeOfIndicator`	Especifica o tipo de estilo do indicador. Opções: `Default Indicator` ou `IndeterminateIndicator`
`HideProgressState`	Especifique true para ocultar o estado de progresso
`BarHeight`	Especifique a altura da barra conforme aplicável

Propriedades de estilo

Propriedade	Description
`Theme`	Aceita uma string JSON que é gerada usando Fluent UI Theme Designer (windows.net). Deixar em branco usará o tema padrão definido pelo Power Apps. Consulte os temas para obter orientação sobre como configurar.
`AccessibilityLabel`	Rótulo Aria do leitor de tela

Comportamental

Exibir o progresso do carregamento

Torne o controle ProgressIndicator propriamente dito (ou a superfície em que ele está localizado) visível quando um processo começa e, depois, atualize uma variável com o valor conforme segmentos do processo forem concluídos. Oculte-o quando o processo for concluído. Use uma variável para controlar a visibilidade do controle e atualizar os valores entre os blocos de código principais do processo que precisam ser indicados.

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

Forneça a variável var_showProgress como o valor da propriedade Visible de ProgressIndicator (ou da superfície que o contém) e atribua a variável var_progressValue para a propriedade Value.

Limitações

Esse componente de tela só pode ser usado em aplicativos de tela e páginas personalizadas.

Compartilhar via