progressbar — u_pbt_progressbar #

← Riferimento dei componenti · Sommario della guida

Barra di avanzamento a tema: barra orizzontale o anello, valore numerico o animazione di attesa, percentuale visualizzata, colore a scelta.

▶ Vederlo dal vivo — Applicazione dimostrativa, riquadro Progress: l'anteprima, il codice che lo produce e questa pagina, affiancati.

In breve #

Avvio rapido #

// event open della finestra
uo_progression.ib_label = true      // mostra la percentuale sulla barra
uo_progression.id_value = 0         // punto di partenza

// Durante l'elaborazione : una semplice assegnazione sposta la barra
for ll_i = 1 to ll_total
    of_traiter_ligne(ll_i)
    uo_progression.id_value = (ll_i / ll_total) * 100
next

Proprietà #

Questo componente non espone tooltip (is_tooltip, is_super_tooltip_*): una barra di avanzamento si legge da sé, e un'etichetta al passaggio del mouse arriverebbe sotto il puntatore proprio nel momento in cui l'utente guarda altrove. Metta il commento sullo stato di avanzamento in uno statictext o in una statusbar accanto alla barra.

Metodi #

Event #

Esempi #

Avanzamento determinato con percentuale #

uo_progression.ib_label = true
uo_progression.id_value = 75      // la barra si riempie per tre quarti

Avanzamento indeterminato (durata sconosciuta) #

// Quando la durata e sconosciuta : la barra si anima in continuo
// e ignora id_value
uo_progression.ib_indeterminate = true

// Una volta nota la durata, si torna alla modalita determinata
uo_progression.ib_indeterminate = false
uo_progression.id_value = 20

Anello circolare #

// Modalita di visualizzazione : linear (barra) o circular (anello)
uo_progression.is_mode  = uo_progression.MODE_CIRCULAR
uo_progression.ib_label = true
uo_progression.id_value = 40

Scala personalizzata #

// L'avanzamento non e sempre una percentuale : si indica la scala reale
uo_progression.il_minimum = 0
uo_progression.il_maximum = ll_nb_lignes    // es : 4820 righe da importare

uo_progression.id_value = ll_ligne_courante // valore grezzo, non una percentuale

La percentuale mostrata da ib_label resta calcolata rispetto a questa scala.

Colore personalizzato e pilotaggio del valore #

uo_progression.ib_label = true

// Il colore di riempimento accetta un RGB() standard di PowerBuilder
uo_progression.il_color = RGB(/*rosso*/ 16, /*verde*/ 137, /*blu*/ 62)

// La barra mostra un valore, non lo calcola : e il vostro codice a farlo avanzare
uo_progression.id_value = 0

// event timer della finestra, una volta al secondo
if uo_progression.id_value >= 100 then
	Timer(0)   // finito : il vostro codice lo sa, e lui che lo ha deciso
	uo_statut.of_item("main").is_text = "Importazione completata"
else
	uo_progression.id_value = uo_progression.id_value + 10
end if

Buone pratiche #

• Scelga la modalità in base a ciò che sa: indeterminata finché il volume è sconosciuto, determinata non appena lo conosce.
• Preferisca il_minimum / il_maximum al calcolo manuale di una percentuale: l'etichetta e la visualizzazione seguono da sole.
• Lasci il_color a -1 affinché la barra segua sia il tema chiaro sia quello scuro; imposti un colore solo per veicolare un significato (verde = riuscita, rosso = allerta).
• Un ciclo PowerScript lungo che non restituisce il controllo blocca la visualizzazione: lasci respirare il ciclo dei messaggi tra un lotto e l'altro (vedere FAQ).
• Chiami of_reset() prima di riutilizzare la stessa barra per un'altra elaborazione.

Ereditato dalla base comune #

Questi membri esistono su tutti i componenti visivi — non sono propri di questo. Sono descritti una sola volta, nei capitoli trasversali; questa tabella dice solo dove leggerli.

Due aiuti non sono ereditati: of_icon e of_escape_markup vivono su n_pbt_utils. Ne dichiari uno — n_pbt_utils lnv_utils, niente da creare — e li chiami su di esso.

← Riferimento dei componenti · Sommario della guida