|--------------------DOCUMENTAZIONE--------------------|
|Tipo di programma:     LIBRERIA                       |
|Nome del programma:    Listview                       |
|Autore:                I.Ren                          |
|Altro:                 autoit.forumcommunity.net      |
|------------------------------------------------------|

1. Sintassi:

Bisogna necessariamente includere la libreria per poterla utilizzare, così:

from listview import *

Per utilizzarla poi:

[...]qui la vostra finestra
lista = ['Parametro1,40','Parametro2','20']
lw = listview(finestra,lista)
[...]qui il resto del vostro codice

Si noti che 40 e 20 sono la lunghezza in pixel di ogni titolo.

2. Parametri:

I parametri sono i seguenti: ([n] quelli necessari, [o] quelli opzionali):

frame       [n]
lista       [n]
spessore    [o]
tipo        [o]

Spiegazioni:

- Frame:
    frame dove si inserirà la listview
- Lista:
    array contenente nomi e lunghezze dei titoli
- Spessore:
    parametro puramente grafico, quanto dev'essere spesso il rettangolo dove c'è il testo
- Tipo:
    è il rilievo. Funziona con le classiche variabili di tkinter (ad esempio: GROOVE, SUNKEN)

3. Lista funzioni:

- listview._aggiungi(cosa):
    Aggiunge un elemento alla listview. "cosa" deve contenere l'elemento da aggiungere ad ogni colonna separato da una | (ad esempio: elemento nella            colonna1|elemento nella colonna2)

- listview._elimina(index):
    Elimina un elemento dalla listview. "index" deve contenere la riga da eliminare

- listview._index():
    Ritorna il numero della riga dell'elemento selezionato

- listview._legtesto(primo,fine):
    Ritorna il testo dell'elemento 'primo' fino all'elemento 'fine'

- listview._lb():
    Ritorna il testo di tutta la listview

4. Esempio

from listview import *

def elimina():
    ind = lw._index()
    lw._elimina(ind)

def aggaltra():
    lw._aggiungi('Skeleton Christ|Slayer|Cristh illusion|Trash metal|2006')

def txtsel():
    ind = lw._index()
    txt = lw._legtesto(ind)
    print(txt)

def tt():
    tutta = lw._lb()
    print(tutta)

def main():
    global lw
    lista = ['Nome canzone,30','Artista,30','Album,25','Genere,25','Anno,10']
    gui = Tk()
    gui.title("Esempio listview.py")
    lw = listview(gui,lista)
    lw._aggiungi('Set to fail|Lamb of God|Wrath|Death metal|2009')
    lw._aggiungi('The anticristh|Slayer|Show no mercy|Trash metal|1983')
    e = Button(gui,text="Elimina",bg="white",font=("Helvetica",10),borderwidth=0.8,command=elimina)
    e.place(x=0,y=160)
    a = Button(gui,text="Aggiungi un'altra canzone",bg="white",font=("Helvetica",10),borderwidth=0.8,command=aggaltra)
    a.place(x=60,y=160)
    lt = Button(gui,text="Leggi il testo selezionato",bg="white",font=("Helvetica",10),borderwidth=0.8,command=txtsel)
    lt.place(x=225,y=160)
    ltt = Button(gui,text="Leggi tutta la listview",bg="white",font=("Helvetica",10),borderwidth=0.8,command=tt)
    ltt.place(x=385,y=160)
    gui.mainloop()

main()