PySide Beginner Examples/it: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
Line 8: Line 8:
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.
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.


Un widget che 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.
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:
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:

Revision as of 11:05, 11 February 2015

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.

Ci 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:

Dichiarazione Import

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

from PySide import QtGui, QtCore

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:

reply = QtGui.QMessageBox.information(None,"","Houston, we have a problem")


Richiedere Si o No

La successiva interazione semplice consiste nel chiedere di rispondere si o no:

reply = QtGui.QMessageBox.question(None, "", "This is your chance to answer, what do you think?",
         QtGui.QMessageBox.Yes | 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


Enter Text Query

The next code snippet asks the user for a piece of text - note this can be any key on the keyboard really:

reply = QtGui.QInputDialog.getText(None, "Ouija Central","Enter your thoughts for the day:")
if reply[1]:
	# user clicked OK
	replyText = reply[0]
else:
	# user clicked Cancel
	replyText = reply[0] # which will be "" if they clicked Cancel


Remember that even if the user enters only digits, "1234" for example, they are strings and must be converted to number representation with either of the following:

anInteger = int(userInput) # to convert to an integer from a string representation

aFloat = float(userInput) # to convert to a float from a string representation