dockcontainer — u_pbt_dockcontainer #

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

Paneles acoplables al estilo de Visual Studio: acoplamiento mediante arrastrar y soltar, apilamiento en pestañas, separadores redimensionables, ventanas flotantes, ocultación automática — y guardado/restauración de la disposición.

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

De un vistazo #

Al igual que tab, cada panel aloja un control real de PowerBuilder (dragobject): userobject, DataWindow u otro componente PBToolboxAI. Véase Alojar controles reales de PowerBuilder.

Inicio rápido #

// event open de la ventana : los controles de panel ya estan colocados en ella
uo_dock.of_add_panel(/*clave*/ "document", /*posicion*/ "", /*relativo_a*/ "", &
                     /*tamano*/ 0, /*titulo*/ "Documento", /*contenido*/ uo_editeur)

uo_dock.of_add_panel(/*clave*/ "explorateur", /*posicion*/ uo_dock.POSITION_START, &
                     /*relativo_a*/ "document", /*tamano*/ 260, &
                     /*titulo*/ "Explorador", /*contenido*/ uo_arbre)

uo_dock.of_add_panel(/*clave*/ "proprietes", /*posicion*/ uo_dock.POSITION_END, &
                     /*relativo_a*/ "document", /*tamano*/ 300, &
                     /*titulo*/ "Propiedades", /*contenido*/ uo_props)

// La zona central : ni cerrable por el acoplamiento, ni flotante, ni ocultable
uo_dock.is_main = "document"

Propiedades #

Posiciones de acoplamiento #

Las constantes del componente alimentan as_position en of_add_panel y of_move_panel:

Propiedades de un panel — n_pbt_dock_panel #

Obtenidas mediante of_panel(clave).

Métodos #

Eventos #

Con el teclado #

El contenido de un panel es un verdadero control PowerBuilder: allí el teclado pertenece a su código, como en cualquier ventana. De lo que se encarga el componente es de su propio armazón — encabezados, pestañas, divisores:

Un divisor es un separator enfocable que anuncia su posición; los botones del encabezado (desacoplar, ocultar, cerrar) llevan un nombre, y el panel activo de un grupo está marcado con aria-selected. Un desplazamiento con el teclado se informa en ue_layout_changed exactamente igual que un arrastre con el ratón.

Ejemplos #

Una ventana al estilo de un IDE #

// event open : cada contenido es un control PB real colocado en la ventana
uo_dock.of_add_panel("document", "", "", 0, "Documento", uo_editeur)
uo_dock.of_add_panel("explorateur", uo_dock.POSITION_START,   "document", 260, "Explorador", uo_arbre)
uo_dock.of_add_panel("proprietes",  uo_dock.POSITION_END,  "document", 300, "Propiedades",  uo_props)
uo_dock.of_add_panel("sortie",      uo_dock.POSITION_BOTTOM, "document", 200, "Salida",      uo_console)

// Un segundo panel apilado como pestana sobre "proprietes"
uo_dock.of_add_panel("aide", uo_dock.POSITION_STACK, "proprietes", 0, "Ayuda", uo_aide)

uo_dock.is_main = "document"

Memorizar y restaurar la disposición del usuario #

// event close de la ventana : guardar lo que el usuario ha organizado
string ls_disposition
ls_disposition = uo_dock.of_get_layout()
of_enregistrer_preference("dock_principal", ls_disposition)

// event open : VOLVER A CREAR primero los paneles, restaurar despues
string ls_disposition

of_creer_les_panneaux()          // las llamadas of_add_panel anteriores

ls_disposition = of_lire_preference("dock_principal")
if ls_disposition <> "" then uo_dock.of_set_layout(ls_disposition)

El orden es obligatorio: of_set_layout no crea ningún panel, solo recoloca los que ya existen.

Seguir los cambios de forma continua #

// event ue_layout_changed de uo_dock : (string as_json)
// Guardado inmediato, sin esperar al cierre de la ventana.
of_enregistrer_preference("dock_principal", as_json)

Controlar un panel mediante su handle #

n_pbt_dock_panel lnv_panneau

lnv_panneau = uo_dock.of_panel("proprietes")
lnv_panneau.is_title  = "Propiedades (3 modificadas)"
lnv_panneau.ib_pinned = false        // se repliega en una lengueta sobre el borde

// Ocultar un panel reservado a los administradores
uo_dock.of_panel("audit").ib_visible = gb_administrateur

Llamar la atención sobre un panel en segundo plano #

// Un proceso en segundo plano ha escrito en la consola : avisar sin robar el foco
uo_dock.of_notify_panel("sortie")

Reorganizar desde el código #

// Mover un panel como si el usuario hubiera arrastrado su pestana
uo_dock.of_move_panel(/*clave*/ "sortie", /*destino*/ "document", /*posicion*/ "bottom")

// Apilarlo como pestana sobre otro panel
uo_dock.of_move_panel(/*clave*/ "aide", /*destino*/ "proprietes", /*posicion*/ "stack")

Desacoplar un panel en una segunda pantalla #

// Ventana flotante nativa : el usuario puede colocarla en otra pantalla
uo_dock.of_float_panel("proprietes")

// event ue_panel_docked de uo_dock : (string as_key)
// El usuario ha cerrado la ventana flotante : el panel ha vuelto.
of_journaliser("Panel reacoplado : " + as_key)

Cerrar correctamente un panel #

// event ue_panel_closed de uo_dock : (string as_key)
// Retirar tambien el panel del contenedor para liberar el control alojado.
uo_dock.of_remove_panel(as_key)

Buenas prácticas #

• Designe siempre un panel principal con is_main: sin zona central, el usuario puede ocultarlo todo y encontrarse ante una ventana vacía.
• Guarde la disposición en ue_layout_changed en lugar de únicamente al cerrar: así un cierre anómalo no pierde nada.
• of_set_layout va después de los of_add_panel, nunca antes.
• Utilice of_notify_panel para los procesos en segundo plano: es menos intrusivo que un cuadro de diálogo y la información permanece visible.
• Un control alojado es una ventana nativa: se dibuja por encima de la capa web, ningún efecto visual del componente pasa por delante de él.
• of_reset() antes de cualquier reconstrucción: sin él, los controles alojados anteriormente siguen reasignados al contenedor vaciado y reutilizar una clave falla.
• Para simples páginas exclusivas, sin acoplamiento ni flotación, tab es más ligero.

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