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.
Parameters:
| Parameter name | Type | Description |
|---|---|---|
| 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. Comportamento diverso da th_options, verificare |
| 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_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 |
| formInIframe | B | Se impostato a True la form sarà caricata in un iframe |
| 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 |