4D Doc Center : Progress SET PROGRESS

4D v14

Progress SET PROGRESS


Progress SET PROGRESS ( id ; progresso {; mensagem {; primeiroPlano}} )

Parâmetro	Tipo	Descrição
id	Inteiro longo	ID da barra de progresso
progresso	Real	Valor de progresso([0...1] ou -1)
mensagem	Texto	Mensagem da barra de progresso
primeiroPlano	Booleano	Mostrar a barra de progresso no primeiro plano

Descrição

O método Progress SET PROGRESS modifica o valor da barra de progresso junto com a informação mostrada na janela de progresso. Este método é útil para a atualização de uma barra de progresso dentro de um bucle.

Em id, passe o número de ID único da barra de progresso, devolvido pelo método Progress New.

Em progresso, passe o valor atual da barra de progresso. Pode passar um valor Real (entre 0 e 1) ou -1 para especificar uma barra de progresso indefinida (também conhecido como "Barber shop" em Mac OS).

Em mensagem, passe um texto adicional para mostrar debaixo do título principal (Windows) ou sob a barra de progresso (Mac OS). Este parâmetro é opcional.

Passe True em primeiroPlano quando queira forçar o passo da janela de progresso ao primeiro plano da aplicação.

Exemplo

Atualização da barra de progresso:

 $P:=Progress New // criamos uma nova barra

  // Realizar um processo em um bucle

 For($i;1;100)

  // ... código do processo

  // Atualizar a barra de progresso

    $r:=$i/100

    Progress SET PROGRESS($P;$r;"More info")

 End for

  // Eliminação da barra uma vez termina o processo

 PROGRESS QUIT($P)