gantt — u_pbt_gantt #

← Riferimento dei componenti · Sommario della guida

gantt pianifica un progetto: a sinistra una griglia di attività (nome, inizio, fine, durata, avanzamento), a destra le loro barre su una scala temporale — giorno, settimana, mese o trimestre — con la linea di oggi (nel colore d'accento) e i giorni non lavorativi ombreggiati. Un'attività che ne contiene altre è un'attività di riepilogo, le cui date e il cui avanzamento sono calcolati; una milestone è un rombo di un giorno; una freccia collega un'attività a quella che la aspetta, e il percorso critico è disegnato in rosso. L'utente trascina una barra per spostarla, il suo bordo finale per cambiarne la fine, il piccolo triangolo sotto per il suo avanzamento; ue_task_moved, ue_task_resized e ue_progress_changed ve lo dicono. Il piano si riempie a mano o da un DataStore, che riceve le modifiche.

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

In breve #

Avvio rapido #

// A phase : the task that holds others becomes a summary
uo_plan.of_add_task(/*keys*/ "build", /*label*/ "Build", /*start*/ "2026-11-02", /*end*/ "2026-11-20")
uo_plan.of_add_task(/*keys*/ "build/design", /*label*/ "Design", /*start*/ "2026-11-02", /*end*/ "2026-11-06")
uo_plan.of_add_task(/*keys*/ "build/code", /*label*/ "Code", /*start*/ "2026-11-09", /*end*/ "2026-11-20")

// A milestone : an instant at the end of its day, here the day the code ends
uo_plan.of_add_milestone(/*keys*/ "golive", /*label*/ "Go-live", /*date*/ "2026-11-20")

// The links : a task starts once the one before it is finished
uo_plan.of_add_dependency(/*from_keys*/ "build/design", /*to_keys*/ "build/code")
uo_plan.of_add_dependency(/*from_keys*/ "build/code", /*to_keys*/ "golive")

// What is done already
uo_plan.of_task(/*keys*/ "build/design").id_progress = 100

// event ue_task_moved of uo_plan : (string as_keys, string as_start, string as_end, string as_old_start, string as_old_end)
// Local variables
string ls_code

// The code of the task : the LAST level of its address ("build/design" -> "design")
ls_code = this.of_task(/*keys*/ as_keys).of_key()

// Save the new dates of the task
UPDATE tasks SET start_date = :as_start, end_date = :as_end WHERE code = :ls_code;

Attività, riepiloghi e milestone #

Un'attività si designa con il suo indirizzo: la sua chiave sotto il genitore, i livelli uniti da / — "build" in alto, "build/design" dentro l'attività "build", aggiunta per prima. Un'attività che ne contiene altre diventa un'attività di riepilogo: una barra sottile, le sue date vanno dal primo inizio all'ultimo giorno di ciò che contiene, il suo avanzamento è la loro media ponderata per le durate. Né l'utente né il vostro codice scrivono le sue date o il suo avanzamento: sono calcolati. La sua freccia, un doppio clic sulla sua riga o ib_collapsed la comprimono; segue ue_task_toggled.

Le date sono giorni interi, aaaa-mm-gg, la fine compresa: un'attività dal 6 al 10 dura cinque giorni, contati sul calendario. of_add_task e of_add_milestone accettano anche due date di PowerBuilder. Una milestone non ha durata: un giorno, un rombo, nessun avanzamento. Tramite l'handle di un'attività (of_task(indirizzo)), scrivere is_start la sposta (la sua durata resta), is_end cambia la sua fine, id_progress il suo avanzamento; un valore scritto dal vostro codice non solleva nulla, come SetItem. Lo stesso handle legge ciò che l'attività è ora: le sue date, la sua durata (of_duration), la sua posizione tra le sorelle a partire da 1 (of_position), il suo livello (of_level).

// The test starts three days later : it moves, its length stays
uo_plan.of_task(/*keys*/ "test").is_start = "2026-11-26"

// Read back what the summary computed
MessageBox("Build", uo_plan.of_task(/*keys*/ "build").is_end + " - " + String(uo_plan.of_task(/*keys*/ "build").id_progress) + " %")

Collegamenti e percorso critico #

of_add_dependency collega due attività con una freccia. Il tipo predefinito è fine-inizio (DEP_FS: la successiva inizia quando la precedente è finita); DEP_SS (inizio-inizio), DEP_FF (fine-fine) e DEP_SF (inizio-fine) si danno come terzo argomento. Un collegamento che le date violano — la successiva inizia troppo presto — è disegnato tratteggiato nel colore del pericolo. Un collegamento verso se stessa, tra un'attività e ciò che contiene, un collegamento già presente o uno che chiuderebbe un ciclo è rifiutato (-5). of_dependency_type legge il tipo di un collegamento, of_predecessors e of_successors dell'handle le attività collegate.

Con ib_critical_path = true, il percorso critico è disegnato nel colore del pericolo: le attività e i collegamenti senza margine, quelli che spostano la fine del progetto se slittano di un giorno. of_is_critical dell'handle lo legge, che il percorso sia disegnato o no. Con ib_link_by_mouse = true, due punti compaiono ai lati della barra sotto il puntatore: l'utente ne trascina uno su un'altra attività, e ue_link_requested dice il collegamento richiesto — il suo tipo segue il punto di partenza e la metà della barra di destinazione. Il diagramma non aggiunge nulla da sé: of_add_dependency quando la vostra applicazione è d'accordo. Un clic su una freccia solleva ue_dependency_clicked. Il margine si conta in giorni lavorativi (is_work_days): un'attività che finisce di venerdì seguita da una che inizia il lunedì non ne ha. Una milestone è un istante alla fine del suo giorno: posta il giorno in cui finisce l'attività che segue, il collegamento è rispettato, e l'attività successiva inizia il giorno dopo. Un collegamento che tocca un'attività di riepilogo vincola le attività che contiene; un riepilogo non è mai segnato, e una freccia è rossa solo tra due barre rosse. Un'attività terminata (100 %) non è mai segnata: non guida più nulla. is_project_end conta il margine fino a una scadenza invece che fino all'ultima fine.

Calendario: festivi, ritardi sui collegamenti, marcatori e attività in ritardo #

Un progetto segue un calendario. is_work_days indica i giorni lavorativi della settimana; of_add_holiday aggiunge un giorno festivo, uno alla volta — ombreggiato come un fine settimana, nominato nel tooltip del suo giorno alla scala giorno, non conta né nel margine del percorso critico né in un ritardo. Un collegamento può portare un ritardo in giorni lavorativi: of_add_dependency("design", "build", DEP_FS, 2) lascia due giorni lavorativi tra la fine dell'una e l'inizio dell'altra (un'asciugatura, una consegna); negativo, è un anticipo. La regola della freccia e il percorso critico lo contano, of_dependency_lag lo rilegge, un DataStore lo scrive dopo il tipo ("12:fs+2"). of_add_marker traccia un marcatore verticale alla fine di un giorno — una scadenza contrattuale, la fine di uno sprint — con la sua etichetta in alto. Infine, con ib_show_late = true, un'attività in ritardo — il suo ultimo giorno è passato (is_today) e non è finita — è disegnata in ambra tratteggiata; of_is_late() del suo handle e il campo {late} dei modelli lo dicono in ogni caso.

// The public holidays of the year : days off, never float
uo_plan.of_add_holiday(/*date*/ "2026-11-11", /*label*/ "Armistice Day")
uo_plan.of_add_holiday(/*date*/ "2026-12-25", /*label*/ "Christmas")

// The paint dries two working days before the second coat
uo_plan.of_add_dependency(/*from_keys*/ "paint", /*to_keys*/ "second_coat", /*type*/ u_pbt_gantt.DEP_FS, /*lag*/ 2)

// The contractual deadline, in red
uo_plan.of_add_marker(/*key*/ "deadline", /*date*/ "2026-12-18", /*label*/ "Contract", /*color*/ RGB(/*red*/ 196, /*green*/ 43, /*blue*/ 28))

// The tasks behind schedule, in amber
uo_plan.ib_show_late = true

Ciò che l'utente cambia #

L'utente trascina una barra per spostare l'attività, per giorni interi (ue_task_moved), il suo bordo finale per cambiarne la fine (ue_task_resized), il piccolo triangolo sotto la barra per il suo avanzamento (ue_progress_changed); un fumetto mostra le date o la percentuale durante il trascinamento, Esc annulla. Da tastiera, Ctrl + Sinistra / Destra sposta l'attività selezionata di un giorno e Ctrl + Maiusc + Sinistra / Destra ne cambia la fine. Gli eventi arrivano con l'attività già al suo posto. Solo un gesto li solleva: una data scritta dal vostro codice è muta, come SetItem. Un'attività di riepilogo non si trascina, né un'attività o un diagramma ib_read_only.

Con ib_veto_changes = true, ue_task_changing è posto prima di ciascuna di queste tre modifiche, con le date e l'avanzamento che l'attività prenderebbe: restituire FALSE la lascia com'era. Canc sull'attività selezionata solleva ue_delete_requested: il diagramma non toglie nulla, of_remove_task quando la vostra applicazione è d'accordo.

Scala, griglia e disposizione #

La scala (is_scale) si sceglie nella barra degli strumenti (ib_toolbar, con il pulsante Oggi), con Ctrl + rotellina — il giorno sotto il puntatore resta sotto il puntatore — o dal vostro codice; segue ue_scale_changed. Alle scale giorno e settimana, i giorni non lavorativi (is_work_days) sono ombreggiati. La griglia mostra le colonne di is_columns, nel loro ordine, con le date scritte secondo is_date_format; l'utente trascina la linea tra griglia e diagramma (ii_grid_width) e il bordo di un'intestazione di colonna per la sua larghezza. Ciò che ha sistemato — la scala, le larghezze, i riepiloghi compressi — si legge con of_get_layout, si restituisce con of_set_layout, e ogni cambiamento solleva ue_layout_changed con la disposizione intera: salvatela, restituitela al prossimo avvio.

Il testo delle barre e dei tooltip #

Il testo accanto a ogni barra è scritto da un modello, is_bar_template ("{label}" per impostazione predefinita, vuoto per nessuno), e il tooltip di una barra da is_tooltip_title_template e is_tooltip_template: testo formattato con tag dove {owner} è un campo dell'attività — uno dei vostri (of_set_field), una colonna del DataStore da cui proviene, o un campo predefinito (label, key, keys, start, end, duration, days, progress, percent, milestone, summary, critical, late, level, parent). {end:d mmm} scrive una data con i simboli d dd ddd dddd m mm mmm mmmm yy yyyy, {?owner}…{/owner} mantiene un pezzo quando il campo dice qualcosa, {!owner}…{/owner} quando non dice nulla, {x:raw} mantiene un valore come tag, {{ }} sono parentesi graffe. {label} e {parent} sono tag, come nella griglia; ogni altro valore è mostrato così com'è, mai letto come tag. Un nome di campo predefinito non è mai vostro: of_set_field lo rifiuta, e una colonna del DataStore con quel nome è nascosta da esso. Un'attività con un proprio tooltip (is_tooltip del suo handle) mostra quello.

// Who does what : a field of our own on a task
uo_plan.of_set_field(/*keys*/ "build/design", /*field*/ "owner", /*value*/ "Ada")

// Beside each bar : the label, the owner when there is one, the end day
uo_plan.is_bar_template = "{label}{?owner} - [b]{owner}[/b]{/owner} [symbol=calendar] {end:d mmm}"

Da un DataStore #

of_from_datastore fa un'attività di ogni riga. La sua chiave è il valore della colonna ROLE_KEY — un identificativo — o, senza di essa, il RowID della riga; la colonna ROLE_PARENT nomina la chiave dell'attività che la contiene (vuota: in alto; un genitore non trovato o un ciclo mette la riga in alto). Una colonna svolge un ruolo quando ne porta il nome (key, parent, label, start, end, progress, milestone, color, predecessors) o quando of_map lo dice. ROLE_MILESTONE fa una milestone di ogni valore che dice sì; ROLE_COLOR colora la barra (un RGB() di PowerBuilder o #rrggbb); ROLE_PREDECESSORS elenca le attività attese, le loro chiavi separate da virgole, il tipo dopo : quando non è fine-inizio: "12, 14:ss". Le date sono lette nell'ordine regionale della postazione. Tutte le colonne sono campi dei modelli. Le attività di un caricamento precedente se ne vanno (i loro handle sono liberati), quelle aggiunte a mano restano. Due righe con la stessa chiave: la seconda diventa key~RowID; una chiave che contiene / o | prende il RowID, e i suoi figli la ritrovano dal suo valore; una chiave che un'attività aggiunta a mano porta già diventa key~RowID, sotto lo stesso genitore — nessuna riga viene mai scartata. Una riga con inizio vuoto è un'attività non pianificata: la griglia lo dice, non ha barra e nessun gesto la sposta. Date e decimali sono letti qualunque siano le impostazioni regionali (12,5 vale 12.5). of_from_datastore accetta anche un DataWindow o un DataWindowChild: le righe che l'utente vede accanto al diagramma, riscritte lì. Dopo un Reset o un Retrieve del DataStore, ridatelo: i suoi RowID ripartono da capo.

Con ib_write_back = true, un gesto scrive nella riga prima del suo evento: le date di inizio e di fine per uno spostamento o una nuova fine, l'avanzamento per il triangolo — ogni valore nel tipo della sua colonna. L'evento legge il DataStore aggiornato, l'Update resta a voi. Un valore che il DataStore rifiuta rimette l'attività com'era, e anche ciò che era già scritto, e solleva ue_write_back_failed al posto dell'evento del gesto. Dopo aver cambiato voi stessi una riga, of_reload_row la rimanda al diagramma; arriva anche una riga inserita nel frattempo. Un'attività che rimuovete (of_remove_task) resta fuori fino al prossimo of_from_datastore: of_map e il ricaricamento di un'altra riga non la riportano, of_reload_row della sua riga sì. Dopo of_clear, of_reload_row rifiuta (-5) fino a un nuovo caricamento.

// Which column of the DataStore plays which role
uo_plan.of_map(/*role*/ u_pbt_gantt.ROLE_KEY, /*column*/ "id")
uo_plan.of_map(/*role*/ u_pbt_gantt.ROLE_PARENT, /*column*/ "parent_id")
uo_plan.of_map(/*role*/ u_pbt_gantt.ROLE_START, /*column*/ "start_date")
uo_plan.of_map(/*role*/ u_pbt_gantt.ROLE_END, /*column*/ "end_date")
uo_plan.of_map(/*role*/ u_pbt_gantt.ROLE_PREDECESSORS, /*column*/ "after")

// A change goes into the DataStore, then the rows become tasks
uo_plan.ib_write_back = true
uo_plan.of_from_datastore(/*ads*/ ids_tasks)

Proprietà #

Proprietà di un'attività — n_pbt_gantt_task #

Il suo handle, tramite of_task(indirizzo). Una lettura chiede al diagramma cosa sia l'attività ora; un valore scritto è muto, come SetItem; ib_collapsed è un ordine e solleva ue_task_toggled. Il suo of_count() conta le attività che contiene e il suo of_keys_at(n) restituisce l'indirizzo dell'n-esima.

Costanti #

Metodi #

Eventi #

Tastiera e mouse #

• Trascinare una barra la sposta per giorni interi, il suo bordo finale ne cambia la fine, il piccolo triangolo sotto il suo avanzamento; un fumetto mostra le date o la percentuale, Esc annulla.
• Su / Giù: l'attività sopra, sotto; Inizio / Fine: la prima, l'ultima; Pag su / Pag giù: una pagina più in alto, più in basso. La vista segue l'attività selezionata.
• Destra apre un'attività di riepilogo compressa, poi scende alla sua prima attività; Sinistra comprime un'attività di riepilogo aperta, poi risale al genitore. Letto da destra a sinistra, Sinistra e Destra si invertono.
• Ctrl + Sinistra / Destra sposta l'attività di un giorno, Ctrl + Maiusc + Sinistra / Destra ne cambia la fine di un giorno.
• Invio o doppio clic apre l'attività, Canc ne chiede l'eliminazione, clic destro o tasto Menu (Maiusc + F10): ue_task_rclicked. Un doppio clic sulla riga di un'attività di riepilogo la comprime o la apre.
• Ctrl + rotellina cambia scala, il giorno sotto il puntatore restando al suo posto; la rotellina sulla griglia fa scorrere il diagramma.
• Trascinare la linea tra griglia e diagramma cambia la larghezza della griglia, trascinare il bordo di un'intestazione quella della sua colonna.
• Il diagramma è un arresto di Tab, la linea tra griglia e diagramma un secondo: Sinistra / Destra la spostano di 10 px (Maiusc: 50), Inizio nasconde la griglia.
• Alt + Sinistra / Destra fa scorrere il tempo, la selezione resta; un clic nella parte vuota di una riga del diagramma seleziona la sua attività.
• Vicino a un bordo, durante un trascinamento, il diagramma scorre da solo: lungo il tempo per una barra, in alto o in basso per un collegamento.
• La barra degli strumenti è un arresto di Tab: Sinistra / Destra passano da un pulsante all'altro, Invio o Spazio lo preme. Nel diagramma, Ctrl + Più / Meno cambia scala, Ctrl + Inizio riporta oggi in vista, Ctrl + Su / Giù cambia l'avanzamento dell'attività di 10 punti.
• Durante il tracciamento di un collegamento, la barra mirata è cerchiata, con un bordo spesso dal lato che terrebbe; un collegamento già presente o che chiuderebbe un ciclo è cerchiato di grigio e non è richiesto.

Esempi #

Regole di pianificazione #

// Once, after the plan is built : ask before each change of the user
uo_plan.ib_veto_changes = true

// event ue_task_changing of uo_plan : nothing ends after the go-live
if as_keys <> "golive" and as_end > this.of_task(/*keys*/ "golive").is_start then return false

// and nothing moves into the past : a task already started keeps its start
if as_start < String(Today(), "yyyy-mm-dd") and as_start < this.of_task(/*keys*/ as_keys).is_start then return false
return true

Collegamenti tracciati con il mouse #

// Once : two dots beside the bar under the pointer, the critical path in red
uo_plan.ib_link_by_mouse = true
uo_plan.ib_critical_path = true

// event ue_link_requested of uo_plan : the chart adds nothing by itself
if this.of_add_dependency(/*from_keys*/ as_from_keys, /*to_keys*/ as_to_keys, /*type*/ as_type) = -5 then
	MessageBox("Plan", "This link cannot be added.")
end if

// event ue_dependency_clicked of uo_plan : a click on an arrow removes it
this.of_remove_dependency(/*from_keys*/ as_from_keys, /*to_keys*/ as_to_keys)

Ritrovare la disposizione al prossimo avvio #

// The layout stored at the last start, if any
uo_plan.of_set_layout(/*layout_json*/ ProfileString(gs_ini, "plan", "layout", ""))

// event ue_layout_changed of uo_plan : store every change
SetProfileString(gs_ini, "plan", "layout", as_layout_json)

Aprire un'attività nella vostra finestra #

// event ue_task_opened of uo_plan
// Local variables
long ll_row

// The row of the task in the DataStore, whatever key the task had to take
ll_row = this.of_task(/*keys*/ as_keys).of_row()

// A task added by hand has no row
if ll_row = 0 then return

// Edited in your window, then the task follows its row
OpenWithParm(w_task_edit, ll_row)
this.of_reload_row(/*row*/ ll_row)

Buone pratiche #

• Fasi come attività di riepilogo: due o tre livelli bastano, l'utente comprime ciò che non segue.
• Collegamenti piuttosto che date ricopiate: un collegamento che le date violano si vede, una data ricopiata sbaglia in silenzio.
• Il percorso critico acceso quando una data va rispettata: mostra dove un giorno di ritardo costa un giorno al progetto.
• Salvate in ue_task_moved (o lasciate che ib_write_back scriva il DataStore): il diagramma mostra la nuova pianificazione prima che la base dati la conosca.
• Restituite la disposizione (ue_layout_changed, of_set_layout): la scala e le larghezze scelte dall'utente sono sue.

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