aboutsummaryrefslogtreecommitdiffstats
path: root/sources/pyside2/doc/gettingstarted.rst
blob: 55212b1baf24a31bb7aa9736120db549f6f336d0 (plain)
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
===============
Getting Started
===============

To get started with |project|, install the following prerequisites:

* Python v3.5 or later
* libclang v3.9 or later
* Optional: a virtual environment, such as `venv <https://docs.python.org/3/library/venv.html>`_ or `virtualenv <https://virtualenv.pypa.io/en/stable/installation>`_

With these installed, you are ready to install the |project|
packages using the pip wheel. Run the following command from your command
prompt to install::

 python -m pip install --index-url=http://download.qt.io/snapshots/ci/pyside/5.9/latest pyside2 --trusted-host download.qt.io

Now that you have |project| installed, you can test your setup by running the following Python
constructs to print version information:

.. include:: pysideversion.rst
   :start-line: 5
   :end-line: 32

Your |project| setup is ready, so try exploring it further by developing a simple application
that prints "Hello World" in several languages. The following instructions will
guide you through the development process:

* Create a new file named :code:`hello_world.py`, and add the following imports to it.

  ::

        import sys
        import random
        from PySide2 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.

* 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")
                self.text.setAlignment(QtCore.Qt.AlignCenter)

                self.text.setFont(QtGui.QFont("Titillium", 30))
                self.button.setFont(QtGui.QFont("Titillium", 20))

                self.layout = QtWidgets.QVBoxLayout()
                self.layout.addWidget(self.text)
                self.layout.addWidget(self.button)
                self.setLayout(self.layout)

                self.button.clicked.connect(self.magic)


            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 list :code:`hello`. This function
  is called when you click the button.

* 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_())

Your example is ready to be run. Try clicking the button at the bottom
and see which greeting you get.