Barras de Progresso e Indicadores

Sempre que a sua aplicação faça algo que demore uma quantidade de tempo notória, irá querer usar um elemento visual que indique ao utilizador que algo está a acontecer em primeiro plano.

Os controlos do QtQuick oferecem dois componentes úteis que poderá usar para esse fim.

Barra de progresso

O Controls.ProgressBar é um componente que lhe permite incluir facilmente barras de progresso na sua aplicação. Existem quatro propriedades principais que irá necessitar de usar:

• from: o valor mínimo representado pelo início da barra de progresso
• to: o valor máximo representado pelo fim da barra de progresso
• value: o valor actual da acção em curso (p.ex., 50% carregado)
• indeterminate: se a acção que está a ser processada não tem um valor de progresso em concreto, poderá configurar esta propriedade como true para mostrar o utilizador que algo está a acontecer, mas que a sua evolução ainda não está bem definida (mas que o estará em breve).

import QtQuick 2.15
import QtQuick.Controls 2.15 as Controls
import QtQuick.Layouts 1.15
import org.kde.kirigami 2.20 as Kirigami

Kirigami.Page {

    Controls.ProgressBar {
        from: 0
        to: 100
        value: 50
        indeterminate: false
    }
}

Indicador de ocupado

Nos casos em que os tempos de carregamento sejam mais curtos ou em que não seja possível medir o progress, poderá então usar o Controls.BusyIndicator . Este componente oferece uma roda rotativa simples que mostra aos utilizadores que algo está a acontecer.

Controls.BusyIndicator {}

Se quiser que o indicador pare de funcionar, podê-lo-á fazer se mudar a propriedade running para falsa.

Controls.BusyIndicator {
    running: false
}