tab — u_pbt_tab #

← Riferimento dei componenti · Sommario della guida

Schede moderne che ospitano veri controlli PowerBuilder: banda riposizionabile, icone per scheda, schede chiudibili, riordino con il mouse.

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

In breve #

L'argomento chiave: una pagina non è un mockup HTML, è un dragobject PowerBuilder — un userobject, una DataWindow, un gruppo di controlli o persino un altro componente PBToolboxAI. Il componente si occupa del posizionamento, del ridimensionamento e della visualizzazione/nascondimento al cambio di scheda. Vedere Ospitare veri controlli PowerBuilder.

Avvio rapido #

// event open della finestra : ogni pagina e un controllo PB gia posto sulla finestra
uo_tabs.of_add_page(/*key*/ "customers",  /*title*/ "Clienti",  /*page*/ uo_page_customers)
uo_tabs.of_add_page(/*key*/ "invoices", /*title*/ "Fatture", /*page*/ uo_page_invoices, /*closable*/ true)

// Un'icona per scheda, posta sull'handle della pagina
uo_tabs.of_page(/*key*/ "customers").is_icon  = "mono:img\customers.svg"
uo_tabs.of_page(/*key*/ "invoices").is_icon = "mono:img\invoice.svg"

// Mostra la prima scheda
uo_tabs.of_select_page(/*key*/ "customers")

// event ue_selection_changed di uo_tabs : (string as_from_key, string as_key)
// Una chiave vuota : nessuna scheda e piu mostrata (tutte nascoste)
if as_key <> "" then of_load_page(as_key)

Proprietà #

Proprietà di una pagina — n_pbt_tab_page #

Ottenute con of_page(id), si modificano a caldo, senza ricostruire la banda.

Metodi #

of_add_page restituisce un codice negativo se l'identificatore è vuoto, già utilizzato, oppure se il controllo passato non è valido o è già ospitato.

Quando le schede sono troppe — si riducono per stare nella banda, ma mai sotto una larghezza leggibile: l'icona e la croce di chiusura occupano il loro spazio in aggiunta al titolo, mai al suo posto. Quelle che non entrano più escono dalla banda, e alla sua estremità compare un pulsante ···: apre l'elenco di tutte le schede visibili, con l'attiva spuntata, e la scelta vi passa. La scheda attiva resta sempre a schermo. La banda non scorre — quel pulsante è la via verso le schede fuori dal riquadro. Nulla da programmare, il comportamento è automatico.

Tastiera e mouse — Ctrl+Tab e Ctrl+Pag giù passano alla scheda successiva, Ctrl+Maiusc+Tab e Ctrl+Pag su alla precedente: contano solo le schede che possono diventare attive (quelle nascoste e disattivate vengono saltate), e il percorso ricomincia dall'inizio. Questi tasti rispondono quando la tastiera è nella banda delle schede o in una pagina che essa ospita — un controllo PowerBuilder della pagina come un altro componente posto al suo interno; da un controllo fuori dal tab, restano alla finestra. È un gesto dell'utente: ue_selection_changing viene posto se ib_veto_selection è attivo, poi segue ue_selection_changed. Un clic centrale su una scheda chiudibile la chiude, esattamente come la sua croce: stessa domanda ue_tab_closing se ib_veto_close è attivo, poi ue_tab_closed; su una scheda disattivata o non chiudibile non fa nulla. Nulla da programmare. Maiusc+F10 o il tasto Menu su una scheda apre il suo menu sotto la scheda; Ctrl+Maiusc+freccia sposta la scheda che ha il focus quando ib_reorderable è a true. Se una pagina ha bisogno di Ctrl+Tab per sé, metta ib_cycle_keys a false.

Event #

Esempi #

Un raccoglitore di pagine gestionali #

// event open : gli userobject di pagina sono gia posti sulla finestra
uo_tabs.of_set_redraw(/*on*/ false)

// Una scheda per ogni userobject di pagina
uo_tabs.of_add_page(/*key*/ "identity", /*title*/ "Identita",  /*page*/ uo_identity)
uo_tabs.of_add_page(/*key*/ "addresses", /*title*/ "Indirizzi",  /*page*/ uo_addresses)
uo_tabs.of_add_page(/*key*/ "accounting",   /*title*/ "Contabilita", /*page*/ uo_accounting)

// Un'icona per scheda, impostata sull'handle della pagina
uo_tabs.of_page(/*key*/ "identity").is_icon = "mono:img\user.svg"
uo_tabs.of_page(/*key*/ "addresses").is_icon = "mono:img\map.svg"
uo_tabs.of_page(/*key*/ "accounting").is_icon   = "mono:img\euro.svg"

// Un solo rendering per tutto, poi si mostra la prima scheda
uo_tabs.of_set_redraw(/*on*/ true)
uo_tabs.of_select_page(/*key*/ "identity")

Documenti chiudibili, aperti su richiesta #

// Local variables
string ls_key, ls_label

// Aprire un documento in una nuova scheda chiudibile : la sua chiave e il suo titolo
ls_key = "report42"
ls_label = "Rapporto 42"
uo_tabs.of_add_page(/*key*/ ls_key, /*title*/ ls_label, /*page*/ uo_editor, /*closable*/ true, /*icon*/ "mono:img\doc.svg")
uo_tabs.of_select_page(/*key*/ ls_key)

// event ue_tab_closed di uo_tabs : (string as_key)
// La scheda e gia stata rimossa ; resta solo da liberare i Suoi dati gestionali.
of_free_document(as_key)

// La croce solo sulla scheda attiva, un punto su una pagina che contiene
// lavoro non salvato, e un contatore su un'altra
uo_tabs.is_close_mode = uo_tabs.CLOSE_ACTIVE
uo_tabs.of_page(/*key*/ "report42").ib_modified = true
uo_tabs.of_page(/*key*/ "inbox").is_badge = "3"

Pagine create su richiesta #

Una pagina pesante non ha bisogno di esistere prima di essere visitata: la aggiunga senza il suo controllo, e crei il controllo in ue_page_needed, come il CreateOnDemand di un Tab PowerBuilder.

// event open della finestra : le pagine pesanti sono aggiunte SENZA il loro controllo
uo_tabs.of_add_page(/*key*/ "orders", /*title*/ "Ordini")
uo_tabs.of_add_page(/*key*/ "history", /*title*/ "Storico")

// event ue_page_needed di uo_tabs : (string as_key)
// Local variables
u_orders luo_orders

// La pagina e mostrata per la prima volta : creare il suo controllo, poi consegnarlo
if as_key = "orders" then
    parent.OpenUserObject(luo_orders)
    uo_tabs.of_supply_page(/*key*/ as_key, /*page*/ luo_orders)
end if

Riordino con il mouse #

// The user may drag a tab to a new place
uo_tabs.ib_reorderable = true

// event ue_tab_reordered di uo_tabs : (string as_key, integer ai_index)
// ai_index = nuova posizione, a partire da 1 (come of_move_page) : si memorizza l'ordine scelto.
of_save_order(as_key, ai_index)

Banda verticale #

// Banda di schede sul lato sinistro, utile quando le etichette sono lunghe
uo_tabs.is_position = uo_tabs.POSITION_START

Disattivare o nascondere una scheda in base ai diritti #

// Il percorso passa sempre dall'handle della pagina
uo_tabs.of_page(/*key*/ "accounting").ib_enabled = of_is_allowed("accounting")
uo_tabs.of_page(/*key*/ "audit").ib_visible  = gb_expert_mode

Reagire alla selezione #

// event ue_selection_changed di uo_tabs : (string as_from_key, string as_key)
choose case as_key
    case "identity" ; uo_identity.of_refresh()
    case "addresses" ; uo_addresses.of_refresh()
    case "accounting"   ; uo_accounting.of_refresh()
end choose

Rifiutare un cambio di scheda o una chiusura #

// Entrambe le domande vanno ATTIVATE: senza queste righe il componente non
// chiede nulla e cambia pagina o chiude subito.
uo_tabs.ib_veto_selection = true
uo_tabs.ib_veto_close     = true

// event ue_selection_changing di uo_tabs : (string as_from_key, string as_key)
// Restituire FALSE mantiene l'utente sulla pagina che sta lasciando.
if of_page_modified(as_from_key) then
    if MessageBox("Modifiche", "Uscire senza salvare ?", Question!, YesNo!) = 2 then
        return false
    end if
end if
return true

// event ue_tab_closing di uo_tabs : (string as_key)
// Restituire FALSE mantiene aperti la scheda e la sua pagina ospitata.
return not of_page_modified(as_key)

Ripartire da una banda vuota #

// of_reset restituisce OGNI pagina ospitata alla sua finestra di origine prima di svuotare
uo_tabs.of_reset()
uo_tabs.of_add_page(/*key*/ "home", /*title*/ "Home", /*page*/ uo_home)

Buone pratiche #

• I controlli ospitati devono esistere prima della chiamata: li ponga sulla finestra in fase di progettazione, il componente si occupa di nasconderli e riposizionarli.
• Carichi le pagine una sola volta nell'open, poi piloti unicamente la selezione: è più rapido che aggiungere e rimuovere pagine di continuo.
• Chiami of_preload_icons all'avvio se le Sue schede portano icone: in caso contrario, la prima apertura di una scheda nascosta mostra un breve ritardo prima dell'icona.
• Entrambe le domande sono opt-in: metta ib_veto_selection / ib_veto_close a true per poter rifiutare un cambio di scheda o una chiusura (un event lasciato vuoto autorizza sempre l'azione). Ogni domanda costa un andata e ritorno verso PowerBuilder.
• Un controllo ospitato è una finestra nativa: si disegna al di sopra dello strato web. Nessun effetto visivo del componente può passargli sopra.
• Non dimentichi of_reset() prima di ricostruire una banda: senza di esso, riutilizzare un identificatore di pagina fallisce e i controlli precedenti restano visualizzati.
• Per aree ridimensionabili e sganciabili anziché pagine esclusive, preferisca dockcontainer.
• Da tastiera, la barra delle schede segue il suo asse: Sinistra/Destra (invertite nelle lingue da destra a sinistra), Su/Giù nelle posizioni start/end, Inizio/Fine, Invio o Spazio per attivare, Canc per chiudere una scheda chiudibile. Le schede disattivate e quelle uscite dalla barra vengono saltate.
• Molte pagine pesanti? Le aggiunga senza il loro controllo (of_add_page(key, title)) e crei ognuna in ue_page_needed: la schermata si apre in fretta, ed esistono solo le pagine visitate.

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