gantt — u_pbt_gantt #

← Referencia de componentes · Índice de la guía

gantt planifica un proyecto: a la izquierda una cuadrícula de tareas (nombre, inicio, fin, duración, avance), a la derecha sus barras sobre una escala de tiempo — día, semana, mes o trimestre — con la línea de hoy (en el color de acento) y los días no laborables sombreados. Una tarea que contiene otras es una tarea resumen, cuyas fechas y avance se calculan; un hito es un rombo de un día; una flecha une una tarea con la que la espera, y la ruta crítica se dibuja en rojo. El usuario arrastra una barra para moverla, su borde final para cambiar su fin, el pequeño triángulo bajo ella para su avance; ue_task_moved, ue_task_resized y ue_progress_changed se lo dicen. El plan se llena a mano o desde un DataStore, que recibe los cambios.

▶ Verlo en vivo — Aplicación de demostración, mosaico Gantt chart: la vista previa, el código que lo genera y esta página, uno al lado del otro.

De un vistazo #

Inicio rápido #

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

Tareas, resúmenes e hitos #

Una tarea se designa por su dirección: su clave bajo su padre, los niveles unidos por / — "build" arriba, "build/design" dentro de la tarea "build", añadida antes. Una tarea que contiene otras se convierte en una tarea resumen: una barra fina, sus fechas van del primer inicio al último día de lo que contiene, su avance es su media ponderada por las duraciones. Ni el usuario ni su código escriben sus fechas o su avance: se calculan. Su cheurón, un doble clic en su fila o ib_collapsed la pliegan; sigue ue_task_toggled.

Las fechas son días enteros, aaaa-mm-dd, el fin incluido: una tarea del 6 al 10 dura cinco días, contados en el calendario. of_add_task y of_add_milestone aceptan también dos date de PowerBuilder. Un hito no tiene duración: un día, un rombo, ningún avance. Mediante el handle de una tarea (of_task(dirección)), escribir is_start la mueve (su duración se mantiene), is_end cambia su fin, id_progress su avance; un valor escrito por su código no lanza nada, como SetItem. El mismo handle lee lo que la tarea es ahora: sus fechas, su duración (of_duration), su lugar entre sus hermanas desde 1 (of_position), su nivel (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) + " %")

Vínculos y ruta crítica #

of_add_dependency une dos tareas con una flecha. El tipo por defecto es fin a inicio (DEP_FS: la siguiente empieza una vez terminada la anterior); DEP_SS (inicio a inicio), DEP_FF (fin a fin) y DEP_SF (inicio a fin) se dan como tercer argumento. Un vínculo que las fechas rompen — la siguiente empieza demasiado pronto — se dibuja discontinuo en el color de peligro. Un vínculo hacia sí misma, entre una tarea y lo que contiene, un vínculo ya existente o uno que cerraría un bucle se rechaza (-5). of_dependency_type lee el tipo de un vínculo, of_predecessors y of_successors del handle las tareas vinculadas.

Con ib_critical_path = true, la ruta crítica se dibuja en el color de peligro: las tareas y los vínculos sin holgura, los que retrasan el fin del proyecto si se desplazan un día. of_is_critical del handle la lee, esté dibujada o no. Con ib_link_by_mouse = true, aparecen dos puntos a cada lado de la barra bajo el puntero: el usuario arrastra uno sobre otra tarea, y ue_link_requested da el vínculo pedido — su tipo sigue el punto de partida y la mitad de la barra de destino. El diagrama no añade nada por sí mismo: of_add_dependency una vez que su aplicación esté de acuerdo. Un clic en una flecha lanza ue_dependency_clicked. La holgura se cuenta en días laborables (is_work_days): una tarea que termina un viernes seguida de otra que empieza el lunes no tiene ninguna. Un hito es un instante al final de su día: puesto el día en que termina la tarea a la que sigue, el vínculo se cumple, y la tarea que va detrás empieza al día siguiente. Un vínculo que toca una tarea resumen compromete las tareas que contiene; una tarea resumen nunca se marca, y una flecha solo es roja entre dos barras rojas. Una tarea terminada (100 %) nunca se marca: ya no dirige nada. is_project_end cuenta la holgura hasta un plazo en lugar del último fin.

Calendario: festivos, desfases, marcadores y retrasos #

Un proyecto sigue un calendario. is_work_days indica los días laborables de la semana; of_add_holiday añade un día festivo, uno a uno — sombreado como un fin de semana, nombrado en la información emergente de su día en la escala día, no cuenta ni en la holgura de la ruta crítica ni en un desfase. Un vínculo puede llevar un desfase en días laborables: of_add_dependency("design", "build", DEP_FS, 2) deja dos días laborables entre el fin de una y el inicio de la otra (un secado, una entrega); negativo, es un adelanto. La regla de la flecha y la ruta crítica lo cuentan, of_dependency_lag lo relee, un DataStore lo escribe tras el tipo ("12:fs+2"). of_add_marker traza un marcador vertical al final de un día — un plazo contractual, el fin de un sprint — con su etiqueta arriba. Por último, con ib_show_late = true, una tarea retrasada — su último día ha pasado (is_today) y no está terminada — se dibuja en ámbar rayado; of_is_late() de su handle y el campo {late} de las plantillas lo dicen en todo 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

Lo que el usuario cambia #

El usuario arrastra una barra para mover la tarea, por días enteros (ue_task_moved), su borde final para cambiar su fin (ue_task_resized), el pequeño triángulo bajo la barra para su avance (ue_progress_changed); una burbuja muestra las fechas o el porcentaje durante el arrastre, Esc cancela. Con el teclado, Ctrl + Izquierda / Derecha mueve la tarea seleccionada un día y Ctrl + Mayús + Izquierda / Derecha cambia su fin. Los eventos llegan con la tarea ya en su sitio. Solo un gesto los lanza: una fecha escrita por su código es muda, como SetItem. Una tarea resumen no se arrastra, ni una tarea o un diagrama ib_read_only.

Con ib_veto_changes = true, ue_task_changing se plantea antes de cada uno de estos tres cambios, con las fechas y el avance que la tarea tomaría: devolver FALSE la deja como estaba. Supr en la tarea seleccionada lanza ue_delete_requested: el diagrama no quita nada, of_remove_task una vez que su aplicación esté de acuerdo.

Escala, cuadrícula y disposición #

La escala (is_scale) se elige en la barra de herramientas (ib_toolbar, con el botón Hoy), con Ctrl + rueda — el día bajo el puntero se queda bajo el puntero — o desde su código; sigue ue_scale_changed. En las escalas día y semana, los días no laborables (is_work_days) se sombrean. La cuadrícula muestra las columnas de is_columns, en su orden, con sus fechas escritas según is_date_format; el usuario arrastra la línea entre cuadrícula y diagrama (ii_grid_width) y el borde de un encabezado de columna para su anchura. Lo que ha organizado — la escala, las anchuras, los resúmenes plegados — se lee con of_get_layout, se devuelve con of_set_layout, y cada cambio lanza ue_layout_changed con la disposición entera: guárdela y devuélvala en el próximo inicio.

El texto de las barras y de la información emergente #

El texto junto a cada barra se escribe con una plantilla, is_bar_template ("{label}" por defecto, vacía para ninguno), y la información emergente de una barra con is_tooltip_title_template e is_tooltip_template: texto enriquecido con etiquetas donde {owner} es un campo de la tarea — uno de los suyos (of_set_field), una columna del DataStore del que procede, o un campo integrado (label, key, keys, start, end, duration, days, progress, percent, milestone, summary, critical, late, level, parent). {end:d mmm} escribe una fecha con los símbolos d dd ddd dddd m mm mmm mmmm yy yyyy, {?owner}…{/owner} conserva un fragmento cuando el campo dice algo, {!owner}…{/owner} cuando no dice nada, {x:raw} conserva un valor como etiquetas, {{ }} son llaves. {label} y {parent} son etiquetas, como en la cuadrícula; cualquier otro valor se muestra tal cual, nunca se lee como etiquetas. Un nombre de campo integrado nunca es suyo: of_set_field lo rechaza, y una columna del DataStore con ese nombre queda oculta por él. Una tarea con su propia información emergente (is_tooltip de su handle) muestra esa.

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

Desde un DataStore #

of_from_datastore hace una tarea de cada fila. Su clave es el valor de la columna ROLE_KEY — un identificador — o, sin ella, el RowID de la fila; la columna ROLE_PARENT nombra la clave de la tarea que la contiene (vacía: arriba; un padre no encontrado o un bucle pone la fila arriba). Una columna desempeña un rol cuando se llama como él (key, parent, label, start, end, progress, milestone, color, predecessors) o cuando of_map lo dice. ROLE_MILESTONE hace un hito de todo valor que dice sí; ROLE_COLOR colorea la barra (un RGB() de PowerBuilder o #rrggbb); ROLE_PREDECESSORS lista las tareas esperadas, sus claves separadas por comas, el tipo tras : cuando no es fin a inicio: "12, 14:ss". Las fechas se leen en el orden regional del puesto. Todas las columnas son campos de las plantillas. Las tareas de una carga anterior se van (sus handles se liberan), las añadidas a mano se quedan. Dos filas con la misma clave: la segunda pasa a key~RowID; una clave que contiene / o | toma el RowID, y sus hijos la encuentran por su valor; una clave que ya lleva una tarea añadida a mano pasa a key~RowID, bajo el mismo padre — nunca se descarta ninguna fila. Una fila con el inicio vacío es una tarea sin planificar: la cuadrícula lo dice, no tiene barra y ningún gesto la mueve. Fechas y decimales se leen sean cuales sean los ajustes regionales (12,5 vale 12.5). of_from_datastore también acepta un DataWindow o un DataWindowChild: las filas que el usuario ve junto al diagrama, reescritas allí. Tras un Reset o un Retrieve del DataStore, vuelva a darlo: sus RowID empiezan de nuevo.

Con ib_write_back = true, un gesto escribe en la fila antes de su evento: las fechas de inicio y de fin para un movimiento o un nuevo fin, el avance para el triángulo — cada valor en el tipo de su columna. El evento lee el DataStore actualizado, el Update sigue siendo cosa suya. Un valor que el DataStore rechaza devuelve la tarea a como estaba, y también lo que ya estaba escrito, y lanza ue_write_back_failed en lugar del evento del gesto. Tras cambiar usted mismo una fila, of_reload_row la vuelve a enviar al diagrama; una fila insertada desde entonces también llega. Una tarea que usted quita (of_remove_task) queda fuera hasta el próximo of_from_datastore: of_map y la recarga de otra fila no la devuelven, of_reload_row de su propia fila sí. Tras of_clear, of_reload_row rechaza (-5) hasta una nueva carga.

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

Propiedades #

Propiedades de una tarea — n_pbt_gantt_task #

Su handle, mediante of_task(dirección). Una lectura pregunta al diagrama qué es la tarea ahora; un valor escrito es mudo, como SetItem; ib_collapsed es una orden y lanza ue_task_toggled. Su of_count() cuenta las tareas que contiene y su of_keys_at(n) devuelve la dirección de la n-ésima.

Constantes #

Métodos #

Eventos #

Teclado y ratón #

• Arrastrar una barra la mueve por días enteros, su borde final cambia su fin, el pequeño triángulo bajo ella su avance; una burbuja muestra las fechas o el porcentaje, Esc cancela.
• Arriba / Abajo: la tarea de arriba, de abajo; Inicio / Fin: la primera, la última; RePág / AvPág: una página más arriba, más abajo. La vista sigue a la tarea seleccionada.
• Derecha abre una tarea resumen plegada y luego baja a su primera tarea; Izquierda pliega una tarea resumen abierta y luego sube a su padre. Leído de derecha a izquierda, Izquierda y Derecha se invierten.
• Ctrl + Izquierda / Derecha mueve la tarea un día, Ctrl + Mayús + Izquierda / Derecha cambia su fin un día.
• Intro o doble clic abre la tarea, Supr pide su eliminación, clic derecho o tecla Menú (Mayús + F10): ue_task_rclicked. Un doble clic en la fila de una tarea resumen la pliega o la abre.
• Ctrl + rueda cambia de escala, quedándose en su sitio el día bajo el puntero; la rueda sobre la cuadrícula desplaza el diagrama.
• Arrastrar la línea entre cuadrícula y diagrama cambia la anchura de la cuadrícula, arrastrar el borde de un encabezado la de su columna.
• El diagrama es una parada de Tab, la línea entre cuadrícula y diagrama una segunda: Izquierda / Derecha la mueven 10 px (Mayús: 50), Inicio oculta la cuadrícula.
• Alt + Izquierda / Derecha desplaza el tiempo, la selección se queda; un clic en la parte vacía de una fila del diagrama selecciona su tarea.
• Cerca de un borde, durante un arrastre, el diagrama se desplaza solo: a lo largo del tiempo para una barra, hacia arriba o abajo para un vínculo.
• La barra de herramientas es una parada de Tab: Izquierda / Derecha pasan de un botón a otro, Intro o Espacio lo pulsa. En el diagrama, Ctrl + Más / Menos cambia de escala, Ctrl + Inicio trae hoy a la vista, Ctrl + Arriba / Abajo cambia el avance de la tarea en 10 puntos.
• Mientras se traza un vínculo, la barra apuntada se rodea, con un borde grueso del lado que tendría; un vínculo ya existente o que cerraría un bucle se rodea de gris y no se pide.

Ejemplos #

Reglas de planificación #

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

Vínculos trazados con el ratón #

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

Recuperar la disposición en el próximo inicio #

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

Abrir una tarea en su ventana #

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

Buenas prácticas #

• Fases como tareas resumen: dos o tres niveles bastan, el usuario pliega lo que no sigue.
• Vínculos mejor que fechas copiadas: un vínculo que las fechas rompen se ve, una fecha copiada se equivoca en silencio.
• La ruta crítica encendida cuando hay que cumplir una fecha: muestra dónde un día de retraso le cuesta un día al proyecto.
• Guarde en ue_task_moved (o deje que ib_write_back escriba el DataStore): el diagrama muestra la nueva planificación antes de que la base de datos la conozca.
• Devuelva la disposición (ue_layout_changed, of_set_layout): la escala y las anchuras que eligió el usuario son suyas.

Heredado de la base común #

Estos miembros existen en todos los componentes visuales — no son propios de este. Se detallan una sola vez, en los capítulos transversales; esta tabla solo dice dónde leerlos.

Dos ayudas no se heredan: of_icon y of_escape_markup viven en n_pbt_utils. Declare uno — n_pbt_utils lnv_utils, nada que crear — y llámelas sobre él.

← Referencia de componentes · Índice de la guía