PySide Beginner Examples/it

Introduzione
Questa pagina contiene degli esempi di base, adatti ai principianti, per gestire la GUI con PySide. Gli Esempi di PySide di livello medio e gli Esempi di PySide di livello avanzato sono contenuti nelle rispettive pagine.

Chi non ha esperienza di programmazione GUI può inciampare nella parola "widget". Al di fuori dell'ambiente informatico il termine di solito viene inteso come

"'un piccolo gadget o un dispositivo meccanico, in particolare qualcosa il cui nome è sconosciuto o non specificato'"

Nei lavori di GUI come PySide il termine "widget" è utilizzato frequentemente per riferirsi agli elementi visibili della GUI, cioè le finestre, i dialoghi e le caselle di input o output. Tutti gli elementi visibili di PySide sono chiamati widget, e, per coloro che sono interessati, discendono tutti da una classe genitore comune: QWidget. Oltre agli elementi visibili PySide offre anche dei widget per il networking, XML, multimedia, e l'integrazione di database. Ndt: un widget è sostanzialmente un componente visibile.

Se un widget non è incorporato in un widget genitore viene chiamato finestra, e di solito le finestre hanno una struttura e una barra del titolo. I tipi più comuni di finestre sono la "finestra principale" (dalla Classe QMainWindow) e le varie sottoclassi di finestre di dialogo (dalla classe QDialog). La finestra QDialog è modale (cioè l'utente non può fare nulla al di fuori della finestra di dialogo mentre essa è aperta), invece la finestra QMainWindow è non-modale e permette all'utente di interagire in parallelo con altre finestre.

Questa guida è una lista di scorciatoie per fare lavorare rapidamente un programma PySide sotto FreeCAD, non è finalizzata a insegnare Python o PySide. Alcuni siti che lo fanno sono:
 * PySide tutorial in zetcode.com
 * PySide/PyQt Tutorial in PythonCentral.io
 * PySide 1.0.7 Reference in Srinikom.github.io (notare che questo è un manuale di riferimento, non un tutorial)

La dichiarazione Import
PySide non viene caricato automaticamente con Python, prima di usarlo deve essere richiamato. Il seguente comando:

carica le 2 parti di PySide - QtGui possiede le classi per la gestione dell'interfaccia grafica mentre QtCore contiene classi che non riguardano direttamente la gestione della GUI (ad esempio timer e geometria). Anche se è possibile importare solo quello che è necessario, generalmente sono necessarie entrambe e entrambe devono essere importate.

Nota : nei sottostanti esempi di codice la dichiarazione 'import' non è ripetuta, si presuppone che sia già nel file Python.

L'esempio più semplice
L'interazione più semplice con PySide è quella di presentare all'utente un messaggio che può solo essere accettato:



Richiedere una risposta Si o No
La successiva interazione semplice consiste nel chiedere di rispondere si o no: QtGui.QMessageBox.No, QtGui.QMessageBox.No) if reply == QtGui.QMessageBox.Yes:       # this is where the code relevant to a 'Yes' answer goes         pass if reply == QtGui.QMessageBox.No:         # this is where the code relevant to a 'No' answer goes         pass



Richiedere l'inserimento di un testo
La prossima parte di codice chiede all'utente di inserire un testo. Notare che il testo può essere prodotto usando qualsiasi tasto della tastiera:



Ricordare che, anche se vengono inserite solo delle cifre, per esempio "1234", il testo è trattato da stringa e deve essere convertito in numero, intero o in virgola mobile, con uno dei seguenti modi:

More Than 2 Buttons
The final Beginner Level example is of how to build a dialog with an arbitrary number of buttons. This example is programmatically too complex to be invoked from a single Python statement so in some ways it should be on the next page which is PySide Medium examples. But on the other hand this is often all that is needed without getting into complex GUI definitions, so the code is placed at the end of the page of this Beginner PySide page rather than the beginning of the following Medium PySide page.

Each piece of code under test would be in a function with the name 'routine1', 'routine2', etc. As many buttons as you can fit on the screen may be used. Follow the patterns in the code sample and add extra buttons as needed - the Dialog box will set it's width accordingly, up to the width of the screen.



There is a line of code:

which causes the buttons to be in a horizontal line. To put them into a vertical line, change the line of code to read: