Metodo th_top

Come creare toolbar superiori aggiuntive con il metodo th_top

Una View 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.

../../_images/th_sections_fattura_01.png

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:

../../_images/th_sections_fattura_02.png
  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 Metodo th_sections

  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.

Suggerimento

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


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.

Autore della sezione: Valter Vettorello