1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
|
|project| Quick start
======================
Requirements
------------
Before you can install |project|, first you must install the following software:
* Python 3.6+,
* We recommend using a virtual environment, such as
`venv <https://docs.python.org/3/library/venv.html>`_ or
`virtualenv <https://virtualenv.pypa.io/en/latest>`_
Installation
------------
.. raw:: html
<img src="https://qt-wiki-uploads.s3.amazonaws.com/images/8/8a/Pyside6_install.gif"
style="float: right; width: 35%; padding-left: 20px;"
alt="PySide6 installation animation" />
* **Creating and activating an environment**
You can do this by running the following on a terminal:
* :command:`python -m venv env`, (Your Python executable might be called ``python3``)
* :command:`source env/bin/activate` for Linux and macOS
* :command:`env\\\Scripts\\\activate.bat` for Windows
* **Installation**
Now you are ready to install the |project| packages using ``pip``.
From the terminal, run the following command:
* :command:`pip install pyside6`, for the latest version.
* :command:`pip install pyside6==6.0`, for the version ``6.0`` specifically.
* It is also possible to install a specific snapshot from our servers.
To do so, you can use the following command::
pip install --index-url=http://download.qt.io/snapshots/ci/pyside/6.0.0/latest pyside6 --trusted-host download.qt.io
* **Test your installation**
Now that you have |project| installed, test your setup by running the following Python
constructs to print version information::
import PySide6.QtCore
# Prints PySide6 version
print(PySide6.__version__)
# Prints the Qt version used to compile PySide6
print(PySide6.QtCore.__version__)
Create a Simple Application
---------------------------
Your |project| setup is ready. You can explore it further by developing a simple application
that prints "Hello World" in several languages. The following instructions will
guide you through the development process:
* **Imports**
Create a new file named :code:`hello_world.py`, and add the following imports to it.::
import sys
import random
from PySide6 import QtCore, QtWidgets, QtGui
The |pymodname| Python module provides access to the Qt APIs as its submodule.
In this case, you are importing the :code:`QtCore`, :code:`QtWidgets`, and :code:`QtGui` submodules.
* **Main Class**
Define a class named :code:`MyWidget`, which extends QWidget and includes a QPushButton and
QLabel.::
class MyWidget(QtWidgets.QWidget):
def __init__(self):
super().__init__()
self.hello = ["Hallo Welt", "Hei maailma", "Hola Mundo", "Привет мир"]
self.button = QtWidgets.QPushButton("Click me!")
self.text = QtWidgets.QLabel("Hello World",
alignment=QtCore.Qt.AlignCenter)
self.layout = QtWidgets.QVBoxLayout(self)
self.layout.addWidget(self.text)
self.layout.addWidget(self.button)
self.button.clicked.connect(self.magic)
@QtCore.Slot()
def magic(self):
self.text.setText(random.choice(self.hello))
The MyWidget class has the :code:`magic` member function that randomly chooses an item from the
:code:`hello` list. When you click the button, the :code:`magic` function is called.
* **Application execution**
Now, add a main function where you instantiate :code:`MyWidget` and :code:`show` it.::
if __name__ == "__main__":
app = QtWidgets.QApplication([])
widget = MyWidget()
widget.resize(800, 600)
widget.show()
sys.exit(app.exec_())
Run your example by writing the following command: :command:`python hello_world.py`.
Try clicking the button at the bottom to see which greeting you get.
.. image:: pyside-examples/images/screenshot_hello.png
:alt: Hello World application
|