progressbar — u_pbt_progressbar #

← Referência dos componentes · Índice do guia

Barra de progresso com tema: barra horizontal ou anel, valor quantificado ou animação de espera, percentagem apresentada, cor livre.

▶ Ver ao vivo — Aplicação de demonstração, mosaico Progress: a pré-visualização, o código que o produz e esta página, lado a lado.

Em resumo #

Início rápido #

// event open da janela
uo_progression.ib_label = true      // apresenta a percentagem sobre a barra
uo_progression.id_value = 0         // ponto de partida

// Durante o processamento : uma simples atribuicao desloca a barra
for ll_i = 1 to ll_total
    of_traiter_ligne(ll_i)
    uo_progression.id_value = (ll_i / ll_total) * 100
next

Propriedades #

Este componente não publica tooltip (is_tooltip, is_super_tooltip_*): uma barra de progresso lê-se por si própria, e uma etiqueta ao passar o rato surgiria por baixo do ponteiro no preciso momento em que o utilizador olha para outro lado. Coloque o comentário de progresso num statictext ou numa statusbar ao lado da barra.

Métodos #

Eventos #

Exemplos #

Progresso determinado com percentagem #

uo_progression.ib_label = true
uo_progression.id_value = 75      // a barra enche-se ate tres quartos

Progresso indeterminado (duração desconhecida) #

// Quando a duracao e desconhecida : a barra anima-se continuamente
// e ignora id_value
uo_progression.ib_indeterminate = true

// Assim que a duracao for conhecida, volta-se ao modo determinado
uo_progression.ib_indeterminate = false
uo_progression.id_value = 20

Anel circular #

// Modo de apresentacao : linear (barra) ou circular (anel)
uo_progression.is_mode  = uo_progression.MODE_CIRCULAR
uo_progression.ib_label = true
uo_progression.id_value = 40

Escala personalizada #

// O avanco nem sempre e uma percentagem : indica-se a escala real
uo_progression.il_minimum = 0
uo_progression.il_maximum = ll_nb_lignes    // ex : 4820 linhas a importar

uo_progression.id_value = ll_ligne_courante // valor bruto, nao uma percentagem

A percentagem apresentada por ib_label continua a ser calculada em relação a esta escala.

Cor personalizada e controlo do valor #

uo_progression.ib_label = true

// A cor de preenchimento aceita um RGB() padrao do PowerBuilder
uo_progression.il_color = RGB(/*vermelho*/ 16, /*verde*/ 137, /*azul*/ 62)

// A barra mostra um valor, nao o calcula : e o seu codigo que o faz avancar
uo_progression.id_value = 0

// evento timer da janela, uma vez por segundo
if uo_progression.id_value >= 100 then
	Timer(0)   // terminado : o seu codigo sabe-o, foi ele que o decidiu
	uo_statut.of_item("main").is_text = "Importação concluída"
else
	uo_progression.id_value = uo_progression.id_value + 10
end if

Boas práticas #

• Escolher o modo em função do que se sabe: indeterminado enquanto o volume for desconhecido, determinado assim que for conhecido.
• Preferir il_minimum / il_maximum ao cálculo manual de uma percentagem: a etiqueta e a apresentação acompanham automaticamente.
• Deixar il_color a -1 para que a barra siga o tema, tanto claro como escuro; só fixar uma cor para transmitir um significado (verde = êxito, vermelho = alerta).
• Um ciclo PowerScript longo sem devolver o controlo bloqueia a apresentação: deixar respirar o ciclo de mensagens entre dois lotes (ver FAQ).
• Chamar of_reset() antes de reutilizar a mesma barra para outro processamento.

Herdado da base comum #

Estes membros existem em todos os componentes visuais — não são próprios deste. São detalhados uma só vez, nos capítulos transversais; esta tabela apenas diz onde os ler.

Duas ajudas não são herdadas: of_icon e of_escape_markup vivem em n_pbt_utils. Declare um — n_pbt_utils lnv_utils, nada a criar — e chame-as nele.

← Referência dos componentes · Índice do guia