Controllo ProgressIndicator

Articolo
03/21/2023

Un comando utilizzato per creare un'esperienza di caricamento.

Nota

Documentazione e codice sorgente sono disponibili nel repository dei componenti del codice GitHub.

comando ProgressIndicator.

Description

Gli indicatori di avanzamento vengono utilizzati per mostrare lo stato di completamento di un'operazione di durata superiore a due secondi. Se non è possibile determinare lo stato di avanzamento, utilizzare una Casella di selezione o utilizza invece il tipo Indeterminate Indicator. Gli indicatori di avanzamento possono apparire in un nuovo pannello, un riquadro a comparsa, sotto l'interfaccia utente che avvia l'operazione o addirittura sostituire l'interfaccia utente di avvio purché l'interfaccia utente possa tornare se annulli o interrompi l'attività.

Questo componente di codice fornisce un wrapper attorno al controllo ProgressIndicator dell'Interfaccia utente Fluent per l'utilizzo in app canvas e pagine personalizzate. Vedi la documentazione del componente per le procedure consigliate.

Proprietà

Proprietà chiave

Proprietà	Descrizione
`Label`	Etichetta opzionale per casella di selezione.
`Percentage Complete`	Percentuale dell'operazione completata, su una scala da 0 a 1. Se non impostato, verrà visualizzato l'indicatore indeterminato.
`TypeOfIndicator`	Specifica il tipo di stile di indicatore. Scelte: `Default Indicator` o `IndeterminateIndicator`
`HideProgressState`	Specifica vero per nascondere lo stato di avanzamento
`BarHeight`	Specifica l'altezza della barra come applicabile

Proprietà di stile

Proprietà	Descrizione
`Theme`	Accetta una stringa JSON generata utilizzando la finestra di progettazione del tema dell'interfaccia utente Fluent (windows.net). Lasciare questo vuoto comporterà l'utilizzo del tema predefinito definito da Power Apps. Vedi la creazione di temi per istruzioni su come eseguire la configurazione.
`AccessibilityLabel`	Etichetta aria per utilità per la lettura dello schermo

Comportamento

Visualizza l'avanzamento del caricamento

Rendi il comando ProgressIndicator stesso (o la superficie in cui si trova) visibile all'inizio di un processo, quindi aggiorna una variabile con il valore man mano che i segmenti del processo vengono completati. Nascondilo quando il processo viene completato. Utilizza una variabile per controllare la visibilità del controllo e aggiornare i valori tra i blocchi di codice principali del processo che necessitano di indicazione.

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

Fornisci la variabile var_showProgress come valore per la proprietà Visible di ProgressIndicator (o la superficie che lo contiene), e assegna la variabile var_progressValue per la proprietà Value.

Limiti

Questo componente canvas può essere usato solo nelle app canvas e nelle pagine personalizzate.

Condividi tramite