dockcontainer — u_pbt_dockcontainer #

← Riferimento dei componenti · Sommario della guida

Pannelli ancorabili in stile Visual Studio: ancoraggio tramite trascinamento, impilamento in schede, separatori ridimensionabili, finestre mobili, nascondi automaticamente — e salvataggio/ripristino della disposizione.

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

In breve #

Come in tab, ogni pannello ospita un vero controllo PowerBuilder (dragobject): userobject, DataWindow o un altro componente PBToolboxAI. Vedere Ospitare veri controlli PowerBuilder.

Avvio rapido #

// event open della finestra : i controlli dei pannelli sono gia posati su di essa
uo_dock.of_add_panel(/*key*/ "document", /*position*/ "", /*relative_to*/ "", /*size*/ 0, /*title*/ "Documento", /*content*/ uo_editor)

// L'esploratore, agganciato all'inizio del documento, largo 260 pixel
uo_dock.of_add_panel(/*key*/ "explorer", /*position*/ uo_dock.POSITION_START, /*relative_to*/ "document", /*size*/ 260, /*title*/ "Esplora risorse", /*content*/ uo_tree)

// Le proprieta, agganciate alla fine del documento, larghe 300 pixel
uo_dock.of_add_panel(/*key*/ "properties", /*position*/ uo_dock.POSITION_END, /*relative_to*/ "document", /*size*/ 300, /*title*/ "Proprieta", /*content*/ uo_props)

// L'area centrale : dall'ancoraggio non e chiudibile, ne mobile, ne nascondibile
uo_dock.is_main = "document"

Proprietà #

Posizioni di ancoraggio #

Le costanti del componente alimentano as_position in of_add_panel e of_move_panel:

Proprietà di un pannello — n_pbt_dock_panel #

Ottenute tramite of_panel(chiave).

Metodi #

Event #

Con il mouse #

Oltre al trascinamento delle schede e degli splitter, tre gesti agiscono su un pannello — mai sul pannello principale:

Da tastiera #

Il contenuto di un pannello è un vero controllo PowerBuilder: lì la tastiera appartiene al suo codice, come in qualunque finestra. Ciò di cui si occupa il componente è la propria cornice — intestazioni, schede, splitter:

Uno splitter è un separator focalizzabile che annuncia la propria posizione; i pulsanti dell'intestazione (staccare, nascondere, chiudere) portano un nome, e il pannello attivo di un gruppo è contrassegnato con aria-selected. Uno spostamento da tastiera risale in ue_layout_changed esattamente come un trascinamento con il mouse.

Esempi #

Una finestra in stile IDE #

// event open : ogni contenuto e un vero controllo PB posato sulla finestra
uo_dock.of_add_panel(/*key*/ "document", /*position*/ "", /*relative_to*/ "", /*size*/ 0, /*title*/ "Documento", /*content*/ uo_editor)
uo_dock.of_add_panel(/*key*/ "explorer", /*position*/ uo_dock.POSITION_START, /*relative_to*/ "document", /*size*/ 260, /*title*/ "Esplora risorse", /*content*/ uo_tree)
uo_dock.of_add_panel(/*key*/ "properties", /*position*/ uo_dock.POSITION_END, /*relative_to*/ "document", /*size*/ 300, /*title*/ "Proprieta", /*content*/ uo_props)
uo_dock.of_add_panel(/*key*/ "output", /*position*/ uo_dock.POSITION_BOTTOM, /*relative_to*/ "document", /*size*/ 200, /*title*/ "Output", /*content*/ uo_console)

// Un secondo pannello impilato come scheda su "properties"
uo_dock.of_add_panel(/*key*/ "help", /*position*/ uo_dock.POSITION_STACK, /*relative_to*/ "properties", /*size*/ 0, /*title*/ "Guida", /*content*/ uo_help)

// Il documento e l'area centrale
uo_dock.is_main = "document"

Memorizzare e ripristinare la disposizione dell'utente #

// event close della finestra : salvare cio che l'utente ha organizzato
string ls_layout
ls_layout = uo_dock.of_get_layout()
of_save_setting(/*name*/ "main_dock", /*value*/ ls_layout)

// event open : RICREARE prima i pannelli, ripristinare poi
string ls_layout

// Prima i pannelli : le chiamate of_add_panel qui sopra
of_create_panels()

// Poi la disposizione salvata all'ultima chiusura, se esiste
ls_layout = of_read_setting(/*name*/ "main_dock")
if ls_layout <> "" then uo_dock.of_set_layout(/*json*/ ls_layout)

L'ordine è tassativo: of_set_layout non crea alcun pannello, si limita a ricollocare quelli già esistenti.

Seguire le modifiche in continuo #

// event ue_layout_changed di uo_dock : (string as_json)
// Salvataggio immediato, senza attendere la chiusura della finestra.
of_save_setting(/*name*/ "main_dock", /*value*/ as_json)

Pilotare un pannello tramite il suo handle #

// Local variables
n_pbt_dock_panel lnv_panel

// Il pannello delle proprieta : un titolo che conta le modifiche, compresso sul suo bordo
lnv_panel = uo_dock.of_panel(/*key*/ "properties")
lnv_panel.is_title  = "Proprietà (3 modificate)"
lnv_panel.ib_pinned = false        // si ripiega a linguetta sul bordo

// Nascondere un pannello riservato agli amministratori
uo_dock.of_panel(/*key*/ "audit").ib_visible = gb_administrator

Attirare l'attenzione su un pannello in secondo piano #

// Un'elaborazione in background ha scritto nella console : segnalare senza rubare il focus
uo_dock.of_notify_panel(/*key*/ "output")

Riorganizzare dal codice #

// Spostare un pannello come se l'utente avesse trascinato la sua scheda
uo_dock.of_move_panel(/*key*/ "output", /*target*/ "document", /*position*/ "bottom")

// Impilarlo come scheda su un altro pannello
uo_dock.of_move_panel(/*key*/ "help", /*target*/ "properties", /*position*/ "stack")

Staccare un pannello su un secondo schermo #

// Finestra mobile nativa : l'utente puo posarla su un altro schermo
uo_dock.of_float_panel(/*key*/ "properties")

// event ue_panel_docked di uo_dock : (string as_key)
// L'utente ha richiuso la finestra mobile : il pannello e tornato.
of_log(/*msg*/ "Pannello riancorato : " + as_key)

Chiudere correttamente un pannello #

// event ue_panel_closed di uo_dock : (string as_key)
// Rimuovere anche il pannello dal contenitore per liberare il controllo ospitato.
uo_dock.of_remove_panel(/*key*/ as_key)

Rifiutare la chiusura di un pannello con lavoro non salvato #

// event open della finestra : chiedere prima che un pannello si chiuda (disattivato per impostazione predefinita)
uo_dock.ib_veto_close = true

// ue_panel_closing event of uo_dock : (string as_key) returns boolean
// L'editor contiene ancora modifiche non salvate : il suo pannello resta aperto.
if as_key = "editor" then
    if ib_editor_modified then return false
end if
return true

// Il vostro codice pone la stessa domanda : -4 quando viene rifiutata
if uo_dock.of_close_panel(/*key*/ "editor") = -4 then
    st_status.Text = "Salvate il documento prima di chiudere l'editor."
end if

Buone pratiche #

• Designi sempre un pannello principale con is_main: senza area centrale, l'utente può nascondere tutto e ritrovarsi davanti a una finestra vuota.
• Salvi la disposizione su ue_layout_changed anziché alla sola chiusura: così una chiusura anomala non fa perdere nulla.
• of_set_layout viene dopo le chiamate of_add_panel, mai prima.
• Utilizzi of_notify_panel per le elaborazioni in background: è meno invadente di una finestra di dialogo e l'informazione resta visibile.
• Un controllo ospitato è una finestra nativa: si disegna al di sopra dello strato web, nessun effetto visivo del componente può passargli sopra.
• of_reset() prima di ogni ricostruzione: senza di esso, i controlli precedentemente ospitati restano riagganciati nel contenitore svuotato e il riutilizzo di una chiave non riesce.
• Per semplici pagine esclusive, senza ancoraggio né finestre mobili, tab è più leggero.

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