relatedTableHandler¶
Il relatedTableHandler è in realtà l’estensione della funzionalità di un altro TableHandler «principale» utilizzato in presenza di una table gerarchica, al fine di permettere lo spostamento degli elementi in relazione tra le voci della gerarchia (di default non possibile).
Il TableHandler in figura è reso semplicemente da queste righe di codice:
th = center.plainTableHandler(relation='@tracks_by_genre')
form.htree.relatedTableHandler(th,
dropOnRoot=False,
inherited=True)
Come si può notare, un plainTableHandler (ma è possibile usare qualsiasi altro tipo di TableHandler) viene arricchito con il relatedTableHandler.
Suggerimento
Per le sue caratteristiche questo TableHandler è utilizzabile in presenza di tabelle gerarchiche in cui può essere utile permettere lo spostamento degli elementi tra le voci della gerarchia in relazione.
Parametri:
Nome parametro |
Tipo |
Descrizione |
|---|---|---|
table |
T |
Permette di indicare la table di partenza dei dati |
relation |
T |
In caso di tabella in relazione, permette di indicare la relation_name da seguire per recuperare i dati |
formResource |
T |
Permette di indicare una specifica formResource del Tablehandler da utilizzare |
viewResource |
T |
Permette di indicare una specifica viewResource del Tablehandler da utilizzare |
condition |
T |
Permette di applicare una condizione ai dati forniti dalla relazione o dalla tabella |
title |
T |
Titolo del box occupato dal Tablehandler (visualizzato sopra la griglia) |
delrow |
B |
True o False, se impostato a False disattiva la possibilità di eliminare record |
addrow |
B |
True o False, se impostato a False disattiva la possibilità di aggiungere record |
export |
B |
True o False, se impostato a True permette di esportare i dati in formato Excel |
virtualStore |
B |
True o False, se impostato a True il caricamento dei dati sarà automatico e la ricerca disabilitata. |
view_store_onStart |
B |
In caso di chiamata a un tablehandler con quindi di default uno store statico, al fine di visualizzare i dati nello store al caricamento si può impostare un innesco oppure il parametro view_store_onStart=True |
searchOn |
B |
Se impostato a «False» disabilita la casella di testo per effettuare la ricerca quando questa è già in sostituzione alla query classica (es: quando virtualStore=False) |
extendedQuery |
B |
True o False, se impostato a True attiva la ricerca avanzata e la toolbar di default del tablehandler |
autoSave |
B |
Se impostato a True, il salvataggio automatico delle modifiche sarà abilitato |
grid_autoSelect |
B |
Se impostato a True verrà automaticamente selezionato il primo valore in griglia al caricamento |
grid_multiSelect |
B |
True o False, se impostato a False impedisce la selezione multipla delle celle |
grid_selfDragRows |
B |
True o False, se impostato a True permette l’ordinamento personalizzato delle righe tramite trascinamento |
form_locked |
B |
Permette di scegliere se la Form del th rappresentato si mostrerà di default come aperta o chiusa |
formInIframe |
B |
Se impostato a True la form sarà caricata in un iframe |
configurable |
B |
Di default True, se impostato a False non mostrerà la linguetta per configurare le colonne |
dropOnRoot |
B |
True o False, se impostato a True permette di trascinare una cella della tabella gerarchica sulla categoria primaria (root) |
inherited |
B |
Se impostato a «True», comparirà una checkbox «Contenuti ereditati» che permetterà di visualizzare gli elementi appartenenti ai sottoelementi in una table gerarchica |