.. _le_stampe/stampe_genropy/stampe_risorsa/genro_html/layout:

Layout
======




L'elemento **layout** è un contenitore rettangolare che può essere definito tramite il suo omonimo metodo descrittore come figlio dell'*elemento root* della stampa oppure dentro ad un elemento  :ref:`cell<le_stampe/stampe_genropy/stampe_risorsa/genro_html/cell>`   interno a qualche altro **layout**.
Esso può contenere solamente elementi di tipo  :ref:`row<le_stampe/stampe_genropy/stampe_risorsa/genro_html/row>` , disposti verticalmente uno sotto l'altro.

Es::
 
   layout = header.layout(name='header',um='mm',
                                   lbl_class='smallCaption',
                                   top=1,bottom=1,left=1,right=1,
                                   lbl_height=3,
                                   border_width=.3,
                                   border_color='gray',
                                   style="""text-align:left;text-indent:2mm;""") 
                                   
.. note ::

 row_border, cell_border, lbl_height, lbl_class e content_class possono essere ridefiniti localmente a livello di row e di cell

.. raw:: html

 <hr>

**Parametri:**

+------------------------+------+--------------------------------------------------+
|     Nome parametro     | Tipo |                   Descrizione                    |
+========================+======+==================================================+
|name                    |T     |Il nome del layout, se specificato all'attributo  |
|                        |      |``class`` dell'elemento HTML viene aggiunta una   |
|                        |      |classe composta dal nome seguito da ``_layout``   |
+------------------------+------+--------------------------------------------------+
|um                      |T     |L'unità di misura usata nelle misure degli        |
|                        |      |elementi contenuti nel layout. Di default si usano|
|                        |      |i millimetri e sconsigliamo di modificare questo  |
|                        |      |parametro.                                        |
+------------------------+------+--------------------------------------------------+
|top                     |T     |Top, left, right, bottom: la posizione assoluta   |
|                        |      |del layout all'interno rispetto ai bordi della    |
|                        |      |pagina.                                           |
+------------------------+------+--------------------------------------------------+
|width                   |T     |Larghezza del layout                              |
+------------------------+------+--------------------------------------------------+
|height                  |T     |Altezza del layout                                |
+------------------------+------+--------------------------------------------------+
|row_border              |B     |È un flag booleano che specifica se le linee      |
|                        |      |orizzontali, di separazione tra gli elementi row  |
|                        |      |devono essere visibili. Il valore di default è    |
|                        |      |True.                                             |
+------------------------+------+--------------------------------------------------+
|cell_border             |B     |È un flag booleano che specifica se le linee      |
|                        |      |verticali, di separazione tra gli elementi cell   |
|                        |      |devono essere visibili. Il valore di default è    |
|                        |      |True.                                             |
+------------------------+------+--------------------------------------------------+
|hasBorderTop            |B     |Questo parametro è un flag che indica il bordo    |
|                        |      |superiore, laterale (hasBorderLeft /              |
|                        |      |hasBorderRight) o inferiore (hasBorderBottom) del |
|                        |      |layout deve essere visibile.                      |
+------------------------+------+--------------------------------------------------+
|border_width            |L     |Spessore dei bordi all’interno del layout, in     |
|                        |      |millimetri. Il default è 0.3 mm. Si comporta come |
|                        |      |la proprietà border-style di CSS ed ammette gli   |
|                        |      |stessi valori.                                    |
+------------------------+------+--------------------------------------------------+
|border_color            |T     |Colore dei bordi. Si comporta come la proprietà   |
|                        |      |border-style di CSS ed ammette gli stessi valori. |
+------------------------+------+--------------------------------------------------+
|border_style            |T     |Lo stile dei bordi. Si comporta come la proprietà |
|                        |      |border-style di CSS ed ammette gli stessi valori. |
+------------------------+------+--------------------------------------------------+
|lbl_height              |T     |L’elemento cell supporta come parametro lbl, il   |
|                        |      |quale rappresenta l’etichetta riferita al dato    |
|                        |      |contenuto nella cella stessa. Questo parametro    |
|                        |      |indica l’altezza in millimetri delle etichette di |
|                        |      |tutte le celle definite nel layout.               |
+------------------------+------+--------------------------------------------------+
|lbl_class               |T     |In questo parametro possiamo specificare la classe|
|                        |      |CSS che sarà assegnata al testo contenuto nelle   |
|                        |      |etichette di cella.                               |
+------------------------+------+--------------------------------------------------+
|content_class           |T     |In questo parametro possiamo indicare la classe   |
|                        |      |CSS che sarà assegnata ai valori, cioè ai dati    |
|                        |      |contenuti dalle celle del layout.                 |
+------------------------+------+--------------------------------------------------+