.. _tablehandler/ViewResource/advanced_methods/th_top_method:

Metodo th_top
=============




Come creare toolbar superiori aggiuntive con il metodo th_top
-------------------------------------------------------------
Una  :ref:`View<tablehandler/ViewResource>`  ha una toolbar superiore, contenente quanto necessario per la normale gestione (esecuzione query, impostazione parametri di selezione, stampa, ecc.) del contenuto di una tabella.

Esiste tuttavia la possibilità di aggiungere delle toolbar che permettono di **ospitare dei pulsanti**, in modo da automatizzare il processo di  selezioni dei dati.

.. image:: /_static/images/ViewResource/advanced_methods/th_sections_fattura_01.png
    :width: 480px
    :align: center
    :height: 120px
    
Vediamo ora il codice che permette di aggiungere una toolbar superiore:

::

    def th_top_barrasuperiore(self,top):
        top.slotToolbar('5,sections@acquisti,*,sections@cliente_tipo_codice,5',
                        childname='superiore',_position='<bar',
                        gradient_from='#999',gradient_to='#666')

ed ora vediamo di analizzare gli elementi che la compongono:

.. image:: /_static/images/ViewResource/advanced_methods/th_sections_fattura_02.png
    :width: 600px
    :align: center
    :height: 120px

1) È il parametro ricevuto dalla funzione (un oggetto con nome di default "bar")

2) Ogni funzione che definisce una toolbar superiore deve avere un nome che inizia con th_top seguito da un nome arbitrario

3) Per adesso non ci interessa il contenuto delle sections che verranno trattate nella sezione ad esse dedicata   :ref:`Metodo th_sections<tablehandler/ViewResource/advanced_methods/th_sections_method>` 

4) ``childname`` definisce il nome assegnato all'oggetto che verrà creato

5) Stabilisce la posizione che dovrà avere la toolbar, rispetto alle altre eventualmente definite (compresa la toolbar di default della finestra) in questo caso il parametro ``<bar`` stabilisce che quella che si sta creando debba essere posizionata prima di bar (ovvero della toolbar di default)

6) impostano il valore di due colori per disegnare con un effetto gradiente la toolbar.

.. hint::
  La ``slotToolbar`` può essere utilizzata anche al di fuori dei TableHandler, per esempio in una webpage all'interno di un **framePane**. Si rimanda alla `sezione dedicata ai framePane nella Widgetpedia <https://www.genropy.org/docs/widgetpedia/layout/framepane.html>`_

.. raw:: html

 <hr>

**Parametri:**

+------------------------+------+--------------------------------------------------+
|     Nome parametro     | Tipo |                   Descrizione                    |
+========================+======+==================================================+
|name                    |T     |nome della funzione che deve iniziare con th_top_ |
|                        |      |seguito da un nome arbitrario                     |
|                        |      |(th_top_barrasuperiore)                           |
+------------------------+------+--------------------------------------------------+
|childname               |T     |rappresenta il nome assegnato all'oggetto che     |
|                        |      |viene creato (se non specificato sarà "bar")      |
+------------------------+------+--------------------------------------------------+
|_position               |T     |il valore del parametro (es.: "<bar") indica la   |
|                        |      |posizione verticale in cui verrà creata la        |
|                        |      |toolbar, rispetto ad altre già presenti, in questo|
|                        |      |caso prima di "bar" che è la barra di default     |
|                        |      |della finestra                                    |
+------------------------+------+--------------------------------------------------+
|gradient_from           |T     |Colore iniziale del gradiente utilizzato per      |
|                        |      |disegnare la toolbar                              |
+------------------------+------+--------------------------------------------------+
|gradient_to             |T     |Colore finale del gradiente utilizzato per        |
|                        |      |disegnare la toolbar                              |
+------------------------+------+--------------------------------------------------+
|closable                |B     |Se impostato a True, la toolbar presenterà la     |
|                        |      |linguetta per l'apertura/chiusura e sarà quindi   |
|                        |      |chiudibile. Se invece di True utilizziamo         |
|                        |      |closable='closed', al caricamento si presenterà   |
|                        |      |come chiusa.                                      |
+------------------------+------+--------------------------------------------------+

.. sectionauthor:: Valter Vettorello