.. _widgetpedia/genro/palette: Palette ======= .. toctree:: :maxdepth: 1 :hidden: :titlesonly: paletteImporter Le palette sono strumenti di Genropy che consentono di aprire una finestra di dialogo che interagisce con la schermata principale. La palette è quindi pensata per mostrare una serie di informazioni da cui scegliere, per esempio i tag da assegnare agli utenti, o una serie limitata di categorie prodotto, o una serie di liste. Le palette possono contenere griglie di dati di altre tabelle oppure :ref:`Tree` di valori di una Bag, o ancora un contenuto totalmente personalizzato. paletteGrid ----------- Il primo caso, probabilmente il più tipico, riguarda le grigle di valori, siano queste provenienti da una tabella o invece da una `Bag `_ Lo strumento messo a disposizione da Genropy in entrambi i casi è la ``paletteGrid``. .. raw:: html

Esempio di paletteGrid con dati di una table

La *paletteGrid* riceve un ``paletteCode``, a piacere, che verrà utilizzato anche come ``datapath`` qualora non ne venga indicato uno differente. Viene poi indicata la ``table`` da cui reperire i dati e la relativa ``ViewResource``. Con ``dockButton=True`` si chiede di mostrare la classica icona che ci permetterà di aprire la palette per mostrare i valori. In alternativa, la *paletteGrid* può utilizzare uno *store* di dati non proveniente da una *table*, bensì da una *Bag* appositamente costruita. .. raw:: html

Esempio di paletteGrid con una Bag di dati

Si noti che in questo caso è possibile indicare una ``struct`` con le colonne, le etichette, le dimensioni, ecc della griglia che si vuole utilizzare. Usiamo poi il ``bagStore``, non come parametro ma appeso alla *paletteGrid*, per definire lo ``storepath`` da cui effettuare il reperimento dei dati da mostrare. paletteTree ----------- Quando si ha a disposizione una Bag di dati non siamo però obbligati a visualizzarla come griglia: l'alternativa che abbiamo a disposizione, utile soprattutto per dati gerarchici, è la visualizzazione ad :ref:`albero` . .. raw:: html

Esempio di paletteTree

È possibile indicare uno ``storepath`` dove reperire la Bag dei dati. palettePane ----------- Infine, con il ``palettePane`` è possibile mostrare nella *palette* un contenuto totalmente personalizzato. .. raw:: html

Esempio di palettePane

Si noti che con ``paletteGroup`` andiamo a creare un gruppo, all'interno del quale mostreremo dei *tab* con il contenuto desiderato. È possibile utilizzare come di consueto qualsivoglia tipologia di widget. .. raw:: html