ProgressIndicator Controlo

Artigo
03/21/2023

Um controlo utilizado para criar uma experiência de carregamento.

Nota

A documentação completa e o código de origem encontram-se no repositório de componentes de código do GitHub.

Controlo ProgressIndicator.

Description

Os indicadores de progresso são utilizados para mostrar o estado de conclusão de uma operação com duração superior a dois segundos. Se não for possível determinar o estado do progresso, utilize um Ícone de progresso ou, em vez disso, o tipo Indeterminate Indicator. Os indicadores de progresso podem aparecer num novo painel, numa janela de lista de opções, sob a IU que iniciou a operação ou podem até mesmo substituir a IU que iniciou desde que a IU possa regressar se cancelar ou parar a atividade.

Este componente de código fornece um wrapper em torno do controlo ProgressIndicator da Fluent UI para utilização em aplicações de tela e páginas personalizadas. Consulte a documentação do componente para melhores práticas.

_Propriedades

Propriedades chave

Property	Description
`Label`	Etiqueta opcional para o ícone de progresso.
`Percentage Complete`	Percentagem da operação concluída, na escala de 0 a 1. Se não definido, será apresentado Indicador Indeterminado.
`TypeOfIndicator`	Especifica o tipo do estilo do indicador. Escolhas: `Default Indicator` ou `IndeterminateIndicator`
`HideProgressState`	Especificar como true para ocultar o estado do progresso
`BarHeight`	Especificar a altura da barra conforme aplicável

Propriedades de estilo

Property	Description
`Theme`	Aceita uma cadeia JSON que é gerada através do Estruturador de Teams da Fluent UI (windows.net). Deixar isto em branco irá utilizar o tema predefinido estabelecido pelo Power Apps. Consulte personalizar o tema para obter orientações sobre como configurar.
`AccessibilityLabel`	Etiqueta aria de leitor de ecrã

Comportamento

Apresentar progresso do carregamento

Tornar visível o próprio controlo ProgressIndicator (ou a superfície em que está localizado) quando um processo é iniciado e, em seguida, atualize uma variável com o valor à medida que os segmentos do processo são concluídos. Oculte-o quando o processo for concluído. Utilize uma variável para controlar a visibilidade do controlo e atualizar os valores entre os blocos de código principais do processo que necessitam de 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 para a propriedade Visible de ProgressIndicator (ou a superfície que a contém) e atribua a variável var_progressValue para a propriedade Value.

Limitações

Este componente de tela só pode ser utilizado em aplicações de tela e páginas personalizadas.

Partilhar via