View source for Documentation/Nightly/Developers/Tutorials/PythonAndUIFile

<noinclude>{{documentation/versioncheck}}</noinclude>
Back to [[Documentation/{{documentation/version}}/Developers|Developers Information]]&larr;


This tutorial will demonstrate how UI file created using QtDesigner can be loaded and used from a python script loaded using the Slicer python interactor.

As depicted below, let's assume you created a UI file where a QLineEdit and QPushButton are layout horizontally.

{|
|[[Image:UIFileForPythonExample.png|thumb|600px|Example of UI file with a QPushButton and QLineEdit]]
|}

Loading the UI file and accessing the associated objects can be done using [http://doc.trolltech.com/4.7/quiloader.html QUILoader]. 

The following code snippet aims at loading the UI file and connecting the associated QPushButton and QLineEdit.

<pre>
# Load UI file
uiloader = qt.QUiLoader()
file = qt.QFile("/home/jchris/Projects/sandbox/qSlicerLineEditWidget.ui")
file.open(qt.QFile.ReadOnly)
line_edit_widget = uiloader.load(file)
file.close()

# Get references to both the QPushButton and the QLineEdit
clear_button = line_edit_widget.findChild(qt.QPushButton, 'ClearButton')
line_edit = line_edit_widget.findChild(qt.QLineEdit, 'LineEdit')

clear_button.connect('clicked()', line_edit, 'clear()')

line_edit_widget.show() 
</pre>

== Idea of possible improvements ==
* Instead of obtaining the reference using findChild, it use an helper (to be named properly) to ease the access to members.
For example: 
<pre>
line_edit_widget = HELPER(uiloader.load(file))
line_edit_widget.ClearButton.connect('clicked()', line_edit_widget.LineEdit, 'clear()')
</pre>

or how about 
<pre>
designedFile = HELPER(fileName.ui)
</pre>