.. _tablehandler/FormResource/base_method/th_options_method:

Metodo th_options
=================




Opzioni che regolano il comportamento
-------------------------------------

Come per la  :ref:`ViewResource<tablehandler/ViewResource>` , anche per le Form esiste un metodo con lo stesso nome che consente di *personalizzare* il comportamento della form stessa.

::

    def th_options(self):
        return dict(dialog_height='400px', dialog_width='600px' )

questo è un tipico esempio delle opzioni di base impostate dal package editor sul quale è possibile intervenire.

.. raw:: html

 <hr>

**Parametri:**

+------------------------+------+--------------------------------------------------+
|     Nome parametro     | Tipo |                   Descrizione                    |
+========================+======+==================================================+
|dialog_width            |T     |Permette di indicare la larghezza della finestra  |
|                        |      |di dialogo della Form (es: dialog_width='600px')  |
+------------------------+------+--------------------------------------------------+
|dialog_height           |T     |Permette di indicare l'altezza della finestra di  |
|                        |      |dialogo della Form (es: dialog_height='600px')    |
+------------------------+------+--------------------------------------------------+
|dialog_windowRatio      |T     |Invece di indicare delle dimensioni fisse in      |
|                        |      |termini di width e height, è possibile indicare un|
|                        |      |valore in proporzione alla dimensione complessiva |
|                        |      |della finestra (es: dialog_windowRatio=.8)        |
+------------------------+------+--------------------------------------------------+
|duplicate               |B     |Se impostato a "True" permette di visualizzare il |
|                        |      |bottone che permette la duplicazione immediata del|
|                        |      |record                                            |
+------------------------+------+--------------------------------------------------+
|autoSave                |T     |Se impostato a "True" la form verrà salvata       |
|                        |      |automaticamente a ogni modifica.                  |
+------------------------+------+--------------------------------------------------+
|modal                   |B     |Permette di visualizzare la Form come "modale",   |
|                        |      |ovvero senza la caratteristica barra superiore e  |
|                        |      |con i bottoni "Ritornare", "Annulla" e "Salva" per|
|                        |      |gestire le operazioni                             |
+------------------------+------+--------------------------------------------------+
|searchOn                |B     |In una table gerarchica, se impostato a True      |
|                        |      |permette di mostrare il campo per la ricerca      |
+------------------------+------+--------------------------------------------------+
|form_delete             |B     |Se impostato a False, la Form non presenterà il   |
|                        |      |bottone per l'eliminazione di un record           |
+------------------------+------+--------------------------------------------------+
|form_add                |B     |Se impostato a False, la Form non presenterà il   |
|                        |      |bottone per l'aggiunta di un nuovo record         |
+------------------------+------+--------------------------------------------------+
|form_save               |B     |Se impostato a False non verrà mostrato il bottone|
|                        |      |di salvataggio della Form                         |
+------------------------+------+--------------------------------------------------+
|showtoolbar             |B     |Se impostato a False, la Form non presenterà la   |
|                        |      |toolbar superiore                                 |
+------------------------+------+--------------------------------------------------+
|showfooter              |B     |Se impostato a False, la Form nasconderà la barra |
|                        |      |inferiore                                         |
+------------------------+------+--------------------------------------------------+
|actionMenu              |B     |Se impostato a True mostrerà il menu delle action |
|                        |      |per il record (icona ingranaggio)                 |
+------------------------+------+--------------------------------------------------+
|printMenu               |B     |Se impostato a True permette di visualizzare      |
|                        |      |l'icona per il lancio della stampa del record in  |
|                        |      |oggetto                                           |
+------------------------+------+--------------------------------------------------+
|startKey                |T     |Permette di aprire la Form indicando un record    |
|                        |      |specifico (es: startKey='*newrecord*')            |
+------------------------+------+--------------------------------------------------+
|defaultPrompt           |T     |Permette di indicare una serie di campi,          |
|                        |      |all'interno di un dizionario, da fornire subito al|
|                        |      |clic sul bottone + al momento dell'aggiunta di un |
|                        |      |nuovo record (es: defaultPrompt=dict(title="Nuovo |
|                        |      |record",                                          |
|                        |      |fields=[dict(value='^.titolo',width='15em',       |
|                        |      |lbl='!![it]Titolo')]))                            |
+------------------------+------+--------------------------------------------------+
|allowSaveInvalid        |B     |Se impostato a True, permette di annullare le     |
|                        |      |validazioni e permettere il salvataggio del record|
|                        |      |anche in presenza di campi non validi             |
+------------------------+------+--------------------------------------------------+
|navigation              |B     |Se impostato a False nasconderà la barra di       |
|                        |      |navigazione tra i record della Form               |
+------------------------+------+--------------------------------------------------+
|selector                |B     |Se impostato a True, permette di mostrare un'icona|
|                        |      |con una lente di ingrandimento nella toolbar      |
|                        |      |superiore della Form, che consentirà di spostarsi |
|                        |      |tra i record.                                     |
+------------------------+------+--------------------------------------------------+
|titleTemplate           |T     |Di default equivalente al nome della Tabella,     |
|                        |      |permette invece di specificare un template da     |
|                        |      |utilizzare come titolo                            |
+------------------------+------+--------------------------------------------------+
|lazyBuild               |B     |Se impostato a True, la costruzione della Form    |
|                        |      |sarà "lazy"                                       |
+------------------------+------+--------------------------------------------------+
|readOnly                |B     |Se impostato a True, la Form sarà in sola lettura |
+------------------------+------+--------------------------------------------------+
|audit                   |B     |Se impostato a True mostrerà la record history    |
|                        |      |(lista cambiamenti del record)                    |
+------------------------+------+--------------------------------------------------+
|copypaste               |B     |Se impostato a True permetterà il copia/incolla   |
|                        |      |dei valori del record                             |
+------------------------+------+--------------------------------------------------+
|annotations             |B     |Se abilitato il package ORGN, permette di attivare|
|                        |      |nella Form della table la gestione delle          |
|                        |      |annotazioni                                       |
+------------------------+------+--------------------------------------------------+
|draftInvalid            |B     |                                                  |
+------------------------+------+--------------------------------------------------+
|excludeCols             |T     |                                                  |
+------------------------+------+--------------------------------------------------+
|                         *Tabelle Gerarchiche Parameters*                         |
+------------------------+------+--------------------------------------------------+
|hierarchical            |B     |Se impostato a "True", permette la visualizzazione|
|                        |      |gerarchica della tabella. Può essere anche        |
|                        |      |'closed' (albero gerarchico chiuso al caricamento)|
|                        |      |o 'open' (albero gerarchico aperto)               |
+------------------------+------+--------------------------------------------------+
|tree\_                  |T     |Permette di passare dei parametri al namespace    |
|                        |      |"tree" di una table gerarchica                    |
+------------------------+------+--------------------------------------------------+
|tree_excludeRoot        |B     |In una table gerarchica, se impostato a True      |
|                        |      |permette di escludere la radice primaria          |
|                        |      |dall'albero gerarchico                            |
+------------------------+------+--------------------------------------------------+
|tree_picker             |T     |In una table gerarchica, permette di indicare il  |
|                        |      |campo da usare per il picker                      |
+------------------------+------+--------------------------------------------------+

.. sectionauthor:: Valter Vettorello e Davide Paci