The PyQt Wiki pages aim to provide tutorials and sample code for PyQt4. An overview of PyQt4 was presented at EuroPython 2006. An introduction to using PyQt4 with Qt Designer for the development of GUI applications was given at PyCon UK 2007. PyQt4 is a comprehensive set of Python bindings for Digia's Qt cross platform GUI toolkit. PyQt4 supports Python v2 and v3.
Qt for Windows has some requirements that are given in more detail in the Qt for Windows Requirements document.
If you have obtained a binary package for this platform, consult the installation instructions provided instead of the ones in this document.
Open Source Versions of Qt is not officially supported for use with any version of Visual Studio. Integration with Visual Studio is available as part of the Qt Commercial Edition.
Step 1: Install the License File (commercial editions only)
![Pyqt4 Pyqt4](/uploads/1/2/5/2/125244097/702028044.jpg)
If you have the commercial edition of Qt, copy the license file from your account on dist.trolltech.com into your home directory (this may be known as the
userprofile
environment variable) and rename it to .qt-license
. This renaming process must be done using a command prompt on Windows, not with Windows Explorer. For example on Windows 2000, %USERPROFILE%
should be something like C:Documents and Settingsusername
For the open source version you do not need a license file.
Step 2: Unpack the Archive
Uncompress the files into the directory you want Qt installed; e.g.
C:Qt%VERSION%
.Note: The install path must not contain any spaces or Windows specific file system characters.
Step 3: Set the Environment variables
In order to build and use Qt, the
PATH
environment variable needs to be extended:This is done by adding
c:Qt%VERSION%bin
to the PATH
variable.For newer versions of Windows,
PATH
can be extended through the Control Panel|System|Advanced|Environment variables menu.You may also need to ensure that the locations of your compiler and other build tools are listed in the
PATH
variable. This will depend on your choice of software development environment.Note: If you don't use the configured shells, which is available in the application menu, in the Open Source Versions of Qt,
configure
requires that sh.exe
is not in the path or that it is run from msys
. This also goes for mingw32-make.Step 4: Build the Qt Library
To configure the Qt library for your machine, type the following command in a Visual Studio command prompt:
Type
configure -help
to get a list of all available options. The Configuration Options for Qt page gives a brief overview of these.If you have multiple compilers installed, and want to build the Qt library using a specific compiler, you must specify a
qmake
specification. This is done by pasing -platform <spec>
to configure; for example:In some cases you need to set up the compilation environment before running configure in order to use the right compiler. For instance, you need to do this if you have Visual Studio 2005 installed and want to compile Qt using the x64 compiler because the 32-bit and 64-bit compiler both use the same
qmake
specification file. This is usually done by selecting Microsoft Visual Studio 2005|Visual Studio Tools|<Command Prompt> from the Start menu.The actual commands needed to build Qt depends on your development system. For Microsoft Visual Studio to create the library and compile all the demos, examples, tools and tutorials type:
Note: If you later need to reconfigure and rebuild Qt from the same location, ensure that all traces of the previous configuration are removed by entering the build directory and typing
nmake distclean
before running configure
again.That's all. Qt is now installed.
Qt Demos and Examples
If you are new to Qt, we suggest that you take a look at the demos and examples to see Qt in action. Run the Qt Examples and Demos either by typing
qtdemo
on the command line or through the desktop's Start menu.You might also want to try the following links:
We hope you will enjoy using Qt. Good luck!
© 2016 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.