gantt — u_pbt_gantt #

← Komponentenreferenz · Inhalt des Handbuchs

gantt plant ein Projekt: links ein Raster der Aufgaben (Name, Beginn, Ende, Dauer, Fortschritt), rechts ihre Balken auf einer Zeitskala — Tag, Woche, Monat oder Quartal — mit der Linie von heute (in der Akzentfarbe) und grau hinterlegten arbeitsfreien Tagen. Eine Aufgabe, die andere enthält, ist ein Sammelvorgang, dessen Daten und Fortschritt berechnet werden; ein Meilenstein ist eine Raute von einem Tag; ein Pfeil verbindet eine Aufgabe mit der, die auf sie wartet, und der kritische Pfad wird rot gezeichnet. Der Benutzer zieht einen Balken, um ihn zu verschieben, seinen Endrand, um sein Ende zu ändern, das kleine Dreieck darunter für seinen Fortschritt; ue_task_moved, ue_task_resized und ue_progress_changed sagen es Ihnen. Der Plan wird von Hand oder aus einem DataStore gefüllt, der die Änderungen empfängt.

▶ Live ansehen — Demoanwendung, Kachel Gantt chart: die Vorschau, der zugehörige Code und diese Seite, nebeneinander.

Auf einen Blick #

Schnellstart #

// 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;

Aufgaben, Sammelvorgänge und Meilensteine #

Eine Aufgabe wird über ihre Adresse bezeichnet: ihren Schlüssel unter ihrem Elternteil, die Ebenen durch / verbunden — "build" oben, "build/design" in der zuvor hinzugefügten Aufgabe "build". Eine Aufgabe, die andere enthält, wird zum Sammelvorgang: ein schmaler Balken, seine Daten reichen vom ersten Beginn bis zum letzten Tag dessen, was er enthält, sein Fortschritt ist deren nach Dauer gewichteter Durchschnitt. Weder der Benutzer noch Ihr Code schreiben seine Daten oder seinen Fortschritt: Sie werden berechnet. Sein Winkel, ein Doppelklick auf seine Zeile oder ib_collapsed klappen ihn ein; ue_task_toggled folgt.

Daten sind ganze Tage, jjjj-mm-tt, das Ende inbegriffen: Eine Aufgabe vom 6. bis zum 10. dauert fünf Tage, nach dem Kalender gezählt. of_add_task und of_add_milestone nehmen auch zwei PowerBuilder-Werte vom Typ date. Ein Meilenstein hat keine Dauer: ein Tag, eine Raute, kein Fortschritt. Über den Handle einer Aufgabe (of_task(adresse)) verschiebt das Schreiben von is_start sie (ihre Dauer bleibt), is_end ändert ihr Ende, id_progress ihren Fortschritt; ein von Ihrem Code geschriebener Wert löst nichts aus, wie SetItem. Derselbe Handle liest, was die Aufgabe jetzt ist: ihre Daten, ihre Dauer (of_duration), ihren Platz unter ihren Geschwistern ab 1 (of_position), ihre Ebene (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) + " %")

Verknüpfungen und kritischer Pfad #

of_add_dependency verbindet zwei Aufgaben durch einen Pfeil. Der Standardtyp ist Ende-Anfang (DEP_FS: die nächste beginnt, sobald die vorige beendet ist); DEP_SS (Anfang-Anfang), DEP_FF (Ende-Ende) und DEP_SF (Anfang-Ende) werden als drittes Argument angegeben. Eine Verknüpfung, die die Daten verletzen — die nächste beginnt zu früh —, wird gestrichelt in der Gefahrenfarbe gezeichnet. Eine Verknüpfung zu sich selbst, zwischen einer Aufgabe und dem, was sie enthält, eine schon vorhandene oder eine, die eine Schleife schließen würde, wird abgelehnt (-5). of_dependency_type liest den Typ einer Verknüpfung, of_predecessors und of_successors des Handles die verknüpften Aufgaben.

Mit ib_critical_path = true wird der kritische Pfad in der Gefahrenfarbe gezeichnet: die Aufgaben und Verknüpfungen ohne Puffer, die das Projektende verschieben, wenn sie um einen Tag rutschen. of_is_critical des Handles liest ihn, ob der Pfad gezeichnet ist oder nicht. Mit ib_link_by_mouse = true erscheinen zwei Punkte zu beiden Seiten des Balkens unter dem Mauszeiger: Der Benutzer zieht einen davon auf eine andere Aufgabe, und ue_link_requested nennt die gewünschte Verknüpfung — ihr Typ folgt dem Startpunkt und der Hälfte des Zielbalkens. Das Diagramm fügt nichts von selbst hinzu: of_add_dependency, sobald Ihre Anwendung einverstanden ist. Ein Klick auf einen Pfeil löst ue_dependency_clicked aus. Der Puffer wird in Arbeitstagen gezählt (is_work_days): Eine Aufgabe, die an einem Freitag endet, gefolgt von einer, die am Montag beginnt, hat keinen. Ein Meilenstein ist ein Zeitpunkt am Ende seines Tages: Am Tag gesetzt, an dem die vorangehende Aufgabe endet, ist die Verknüpfung eingehalten, und die nachfolgende Aufgabe beginnt am nächsten Tag. Eine Verknüpfung, die einen Sammelvorgang berührt, bindet die Aufgaben, die er enthält; ein Sammelvorgang wird nie markiert, und ein Pfeil ist nur zwischen zwei roten Balken rot. Eine abgeschlossene Aufgabe (100 %) wird nie markiert: Sie steuert nichts mehr. is_project_end zählt den Puffer bis zu einem Stichtag statt bis zum letzten Ende.

Kalender: Feiertage, Zeitabstände, Markierungen und Verzüge #

Ein Projekt folgt einem Kalender. is_work_days gibt die Arbeitstage der Woche an; of_add_holiday fügt einen Feiertag hinzu, einen nach dem anderen — grau hinterlegt wie ein Wochenende, im Tooltip seines Tages auf der Tagesskala benannt, zählt er weder zum Puffer des kritischen Pfads noch zu einem Zeitabstand. Eine Verknüpfung kann einen Zeitabstand in Arbeitstagen tragen: of_add_dependency("design", "build", DEP_FS, 2) lässt zwei Arbeitstage zwischen dem Ende der einen und dem Beginn der anderen (eine Trocknungszeit, eine Lieferung); negativ ist es ein Vorlauf. Die Regel des Pfeils und der kritische Pfad zählen ihn, of_dependency_lag liest ihn zurück, ein DataStore schreibt ihn hinter den Typ ("12:fs+2"). of_add_marker zeichnet eine senkrechte Markierung am Ende eines Tages — eine vertragliche Frist, das Ende eines Sprints — mit ihrer Beschriftung oben. Schließlich wird mit ib_show_late = true eine verspätete Aufgabe — ihr letzter Tag ist vorbei (is_today) und sie ist nicht fertig — bernsteinfarben schraffiert gezeichnet; of_is_late() ihres Handles und das Feld {late} der Vorlagen sagen es in jedem Fall.

// 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

Was der Benutzer ändert #

Der Benutzer zieht einen Balken, um die Aufgabe in ganzen Tagen zu verschieben (ue_task_moved), seinen Endrand, um ihr Ende zu ändern (ue_task_resized), das kleine Dreieck unter dem Balken für ihren Fortschritt (ue_progress_changed); eine Blase zeigt während des Ziehens die Daten oder den Prozentsatz, Esc bricht ab. Mit der Tastatur verschiebt Strg + Links / Rechts die ausgewählte Aufgabe um einen Tag und Strg + Umschalt + Links / Rechts ändert ihr Ende. Die Ereignisse kommen an, wenn die Aufgabe bereits an ihrem Platz ist. Nur eine Geste löst sie aus: ein von Ihrem Code geschriebenes Datum ist stumm, wie SetItem. Ein Sammelvorgang lässt sich nicht ziehen, ebenso wenig eine Aufgabe oder ein Diagramm mit ib_read_only.

Mit ib_veto_changes = true wird ue_task_changing vor jeder dieser drei Änderungen gestellt, mit den Daten und dem Fortschritt, die die Aufgabe annehmen würde: FALSE zurückzugeben lässt sie, wie sie war. Entf auf der ausgewählten Aufgabe löst ue_delete_requested aus: Das Diagramm entfernt nichts, of_remove_task, sobald Ihre Anwendung einverstanden ist.

Skala, Raster und Layout #

Die Skala (is_scale) wird in der Werkzeugleiste gewählt (ib_toolbar, mit der Schaltfläche Heute), mit Strg + Mausrad — der Tag unter dem Mauszeiger bleibt unter dem Mauszeiger — oder durch Ihren Code; ue_scale_changed folgt. Bei den Skalen Tag und Woche sind die arbeitsfreien Tage (is_work_days) grau hinterlegt. Das Raster zeigt die Spalten von is_columns in ihrer Reihenfolge, seine Daten geschrieben nach is_date_format; der Benutzer zieht die Linie zwischen Raster und Diagramm (ii_grid_width) und den Rand einer Spaltenüberschrift für ihre Breite. Was er angeordnet hat — die Skala, die Breiten, die eingeklappten Sammelvorgänge —, liest man mit of_get_layout, gibt es mit of_set_layout zurück, und jede Änderung löst ue_layout_changed mit dem ganzen Layout aus: Speichern Sie es und geben Sie es beim nächsten Start zurück.

Der Text der Balken und Tooltips #

Der Text neben jedem Balken wird über eine Vorlage geschrieben, is_bar_template (standardmäßig "{label}", leer für keinen), und der Tooltip eines Balkens über is_tooltip_title_template und is_tooltip_template: Rich-Text-Auszeichnung, in der {owner} ein Feld der Aufgabe ist — eines Ihrer eigenen (of_set_field), eine Spalte des DataStores, aus dem sie stammt, oder ein eingebautes Feld (label, key, keys, start, end, duration, days, progress, percent, milestone, summary, critical, late, level, parent). {end:d mmm} schreibt ein Datum mit den Kürzeln d dd ddd dddd m mm mmm mmmm yy yyyy, {?owner}…{/owner} behält ein Stück, wenn das Feld etwas enthält, {!owner}…{/owner}, wenn es nichts enthält, {x:raw} behält einen Wert als Auszeichnung, {{ }} sind geschweifte Klammern. {label} und {parent} sind Auszeichnung, wie im Raster; jeder andere Wert wird so angezeigt, wie er ist, nie als Auszeichnung gelesen. Ein eingebauter Feldname gehört nie Ihnen: of_set_field lehnt ihn ab, und eine gleichnamige DataStore-Spalte wird von ihm verdeckt. Eine Aufgabe mit eigenem Tooltip (is_tooltip ihres Handles) zeigt diesen.

// 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}"

Aus einem DataStore #

of_from_datastore macht aus jeder Zeile eine Aufgabe. Ihr Schlüssel ist der Wert der Spalte ROLE_KEY — eine ID — oder, ohne sie, die RowID der Zeile; die Spalte ROLE_PARENT nennt den Schlüssel der Aufgabe, die sie enthält (leer: oben; ein nicht gefundenes Elternteil oder eine Schleife setzt die Zeile nach oben). Eine Spalte spielt eine Rolle, wenn sie so heißt (key, parent, label, start, end, progress, milestone, color, predecessors) oder wenn of_map es sagt. ROLE_MILESTONE macht aus jedem Wert, der ja sagt, einen Meilenstein; ROLE_COLOR färbt den Balken (ein PowerBuilder-RGB() oder #rrggbb); ROLE_PREDECESSORS listet die abgewarteten Aufgaben, ihre Schlüssel durch Kommas getrennt, den Typ nach :, wenn es nicht Ende-Anfang ist: "12, 14:ss". Datumswerte werden in der regionalen Reihenfolge des Arbeitsplatzes gelesen. Jede Spalte ist ein Feld der Vorlagen. Die Aufgaben eines früheren Ladens verschwinden (ihre Handles werden freigegeben), von Hand hinzugefügte bleiben. Zwei Zeilen mit demselben Schlüssel: Die zweite wird zu key~RowID; ein Schlüssel mit / oder | nimmt die RowID, und seine Kinder finden ihn über seinen Wert; ein Schlüssel, den eine von Hand hinzugefügte Aufgabe schon trägt, wird zu key~RowID, unter demselben Elternteil — keine Zeile geht je verloren. Eine Zeile mit leerem Beginn ist eine nicht geplante Aufgabe: Das Raster sagt es, sie hat keinen Balken und keine Geste verschiebt sie. Datumswerte und Dezimalzahlen werden unabhängig von den Regionaleinstellungen gelesen (12,5 ist 12.5). of_from_datastore nimmt auch ein DataWindow oder ein DataWindowChild: die Zeilen, die der Benutzer neben dem Diagramm sieht, dorthin zurückgeschrieben. Nach einem Reset oder Retrieve des DataStores geben Sie ihn erneut: Seine RowIDs beginnen von vorn.

Mit ib_write_back = true schreibt eine Geste vor ihrem Ereignis in die Zeile: Anfangs- und Enddatum für eine Verschiebung oder ein neues Ende, den Fortschritt für das Dreieck — jeden Wert im Typ seiner Spalte. Das Ereignis liest den aktuellen DataStore, das Update bleibt bei Ihnen. Ein Wert, den der DataStore ablehnt, setzt die Aufgabe zurück, wie sie war, das bereits Geschriebene ebenso, und löst statt des Ereignisses der Geste ue_write_back_failed aus. Nachdem Sie selbst eine Zeile geändert haben, sendet of_reload_row sie erneut an das Diagramm; eine seitdem eingefügte Zeile kommt ebenfalls an. Eine Aufgabe, die Sie entfernen (of_remove_task), bleibt draußen bis zum nächsten of_from_datastore: of_map und das Neuladen einer anderen Zeile bringen sie nicht zurück, of_reload_row ihrer eigenen Zeile schon. Nach of_clear lehnt of_reload_row ab (-5), bis neu geladen wird.

// 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)

Eigenschaften #

Eigenschaften einer Aufgabe — n_pbt_gantt_task #

Ihr Handle, über of_task(adresse). Ein Lesen fragt das Diagramm, was die Aufgabe jetzt ist; ein geschriebener Wert ist stumm, wie SetItem; ib_collapsed ist ein Befehl und löst ue_task_toggled aus. Ihr of_count() zählt die Aufgaben, die sie enthält, und ihr of_keys_at(n) liefert die Adresse der n-ten.

Konstanten #

Methoden #

Ereignisse #

Tastatur und Maus #

• Einen Balken zu ziehen verschiebt ihn in ganzen Tagen, sein Endrand ändert sein Ende, das kleine Dreieck darunter seinen Fortschritt; eine Blase zeigt die Daten oder den Prozentsatz, Esc bricht ab.
• Auf / Ab: die Aufgabe darüber, darunter; Pos1 / Ende: die erste, die letzte; Bild auf / Bild ab: eine Seite höher, tiefer. Die Ansicht folgt der ausgewählten Aufgabe.
• Rechts öffnet einen eingeklappten Sammelvorgang und geht dann zu seiner ersten Aufgabe hinunter; Links klappt einen offenen Sammelvorgang ein und geht dann zu seinem Elternteil hinauf. Von rechts nach links gelesen, tauschen Links und Rechts.
• Strg + Links / Rechts verschiebt die Aufgabe um einen Tag, Strg + Umschalt + Links / Rechts ändert ihr Ende um einen Tag.
• Eingabe oder Doppelklick öffnet die Aufgabe, Entf verlangt ihr Löschen, Rechtsklick oder Menütaste (Umschalt + F10): ue_task_rclicked. Ein Doppelklick auf die Zeile eines Sammelvorgangs klappt ihn ein oder auf.
• Strg + Mausrad wechselt die Skala, wobei der Tag unter dem Mauszeiger an seinem Platz bleibt; das Mausrad über dem Raster scrollt das Diagramm.
• Die Linie zwischen Raster und Diagramm zu ziehen ändert die Breite des Rasters, den Rand einer Spaltenüberschrift zu ziehen die ihrer Spalte.
• Das Diagramm ist ein Tab-Stopp, die Linie zwischen Raster und Diagramm ein zweiter: Links / Rechts verschieben sie um 10 px (Umschalt: 50), Pos1 blendet das Raster aus.
• Alt + Links / Rechts scrollt die Zeit, die Auswahl bleibt; ein Klick in den leeren Teil einer Zeile des Diagramms wählt ihre Aufgabe aus.
• Nahe einem Rand scrollt das Diagramm beim Ziehen von selbst: entlang der Zeit für einen Balken, nach oben oder unten für eine Verknüpfung.
• Die Symbolleiste ist ein Tab-Stopp: Links / Rechts gehen von Schaltfläche zu Schaltfläche, Eingabe oder Leertaste drückt sie. Im Diagramm wechselt Strg + Plus / Minus die Skala, Strg + Pos1 holt heute in den Blick, Strg + Auf / Ab ändert den Fortschritt der Aufgabe um 10 Punkte.
• Beim Ziehen einer Verknüpfung wird der Zielbalken umrandet, mit einem dicken Rand auf der Seite, die sie halten würde; eine schon vorhandene Verknüpfung oder eine, die eine Schleife schließen würde, wird grau umrandet und nicht angefragt.

Beispiele #

Planungsregeln #

// 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

Mit der Maus gezogene Verknüpfungen #

// 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)

Das Layout beim nächsten Start wiederfinden #

// 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)

Eine Aufgabe in Ihrem Fenster öffnen #

// 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)

Bewährte Praxis #

• Phasen als Sammelvorgänge: zwei oder drei Ebenen genügen, der Benutzer klappt ein, was er nicht verfolgt.
• Verknüpfungen statt abgeschriebener Daten: Eine von den Daten verletzte Verknüpfung sieht man, ein abgeschriebenes Datum irrt sich stillschweigend.
• Den kritischen Pfad einschalten, wenn ein Termin zu halten ist: Er zeigt, wo ein Tag Verzug das Projekt einen Tag kostet.
• In ue_task_moved speichern (oder ib_write_back den DataStore schreiben lassen): Das Diagramm zeigt die neue Planung, bevor die Datenbank sie kennt.
• Das Layout zurückgeben (ue_layout_changed, of_set_layout): Die Skala und die Breiten, die der Benutzer gewählt hat, gehören ihm.

Vom gemeinsamen Sockel geerbt #

Diese Mitglieder gibt es bei jeder visuellen Komponente — sie sind nicht dieser eigen. Sie werden einmal in den übergreifenden Kapiteln beschrieben; diese Tabelle sagt nur, wo man sie liest.

Zwei Helfer werden nicht geerbt: of_icon und of_escape_markup liegen auf n_pbt_utils. Deklarieren Sie eines — n_pbt_utils lnv_utils, nichts zu erzeugen — und rufen Sie sie darauf auf.

← Komponentenreferenz · Inhalt des Handbuchs