Qt for Python Tutorial HelloQML: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
No edit summary
(Merge edit by Giddeen)
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Your first application using PySide2 and QtQuick/QML ==


[[Category:PySide]]
QML is a declarative language designed to describe the user interface of a program: both what it looks like, and how it behaves.
In QML, a user interface is specified as a tree of objects with properties.
In this tutorial we will show how you can make a simple '''Hello World''' application with PySide2 and QML.


<big>'''Attention: a port of PySide to Qt 5.x started in 2014, the progress and more details about this project can be found under [[PySide2 | PySide 2]]'''</big>
A PySide2/QML application consists, at least, of two different files - a file with the QML description of the user interface, and a python file which loads the '''qml''' file.
 
To avoid problems for now, don't forget to save both files in the same directory.
'''English''' [[Hello-World-in-PySide-and-QtQuick-Korean|한국어]] [[Hello-World-in-PySide-and-QtQuick-Japanese|日本語]]
 
= Your first application using PySide and QtQuick/QML =
 
QML is a declarative language designed to describe the user interface of a program: both what it looks like, and how it behaves. In QML, a user interface is specified as a tree of objects with properties. In this tutorial we will show how you can make a simple '''Hello World''' application with PySide and QML.
 
A PySide/QML application consists, at least, of two different files - a file with the QML description of the user interface, and a python file which loads the qml file. To avoid problems for now, don't forget to save both files in the same folder.


Here is a simple QML file, called '''view.qml''':
Here is a simple QML file, called '''view.qml''':


<pre>
<syntaxhighlight lang="javascript" line="1">
import QtQuick 1.0
import QtQuick 2.0


Rectangle {
Rectangle {
  width: 200
  width: 200
  height: 200
  height: 200
  color: "red"
  color: "green"


Text {
Text {
Line 27: Line 23:
  }
  }
}
}
</pre>
</syntaxhighlight>


We start by importing QtQuick 1.0, since in theory, QtQuick has a different release schedule than Qt/PySide.
We start by importing QtQuick 2.0, which a separate Qt module.


The rest of the QML code is pretty straightforward for those who have previously used HTML or XML files. Basically, we are creating a red rectangle with the size 200*200 and, inside that rectangle, we are adding a Text element which says '''Hello World'''. The code '''anchors.centerIn: parent''' just makes the text appear centered in relation to its immediate parent.
The rest of the QML code is pretty straightforward for those who have previously used HTML or XML files.
Basically, we are creating a green rectangle with the size 200*200 and, inside that rectangle, we are adding a Text element which says '''Hello World'''.
The code '''anchors.centerIn: parent''' just makes the text appear centered in relation to its immediate parent.


Now, let's see how the code looks on the PySide. Let's call it '''main.py''':
Now, let's see how the code looks on the PySide2. Let's call it '''main.py''':


<pre>
<syntaxhighlight lang="python" line="line">
#!/usr/bin/env python
from PySide2.QtWidgets import QApplication
# -'''- coding: utf-8 -'''-
from PySide2.QtQuick import QQuickView
from PySide2.QtCore import QUrl


import sys
app = QApplication([])
from PySide.QtCore import *
view = QQuickView()
from PySide.QtGui import *
url = QUrl("view.qml")
from PySide.QtDeclarative import QDeclarativeView


# Create Qt application and the QDeclarative view
app = QApplication(sys.argv)
view = QDeclarativeView()
# Create an URL to the QML file
url = QUrl('view.qml')
# Set the QML file and show
view.setSource(url)
view.setSource(url)
view.show()
view.show()
# Enter Qt main loop
app.exec_()
sys.exit(app.exec_())
</syntaxhighlight>
</pre>
 


If you are already familiar with PySide and have followed our tutorials, much of this code is already familiar. The only novelties are that you must import QDeclarativeView and set the source of the QDeclarativeView object to the URL of your QML file. Then, as any Qt widget, you call '''QDeclarativeView.show()'''.
If you are already familiar with PySide2 and have followed our tutorials, much of this code is already familiar.
The only novelties are that you must import QtQuick and set the source of the QQuickView object to the URL of your QML file.
Then, as any Qt widget, you call '''QQuickView.show()'''.


'''Hint:''' If you are programming for desktop, you should consider adding '''view.setResizeMode(QDeclarativeView.SizeRootObjectToView)''' before showing the view. This will force the outer QML rectangle to resize along with the outer window.
'''Hint:''' If you are programming for desktop, you should consider adding '''view.setResizeMode(QQuickView.SizeRootObjectToView)''' before showing the view.
This will force the outer QML rectangle to resize along with the outer window.

Latest revision as of 07:30, 17 May 2018

Your first application using PySide2 and QtQuick/QML

QML is a declarative language designed to describe the user interface of a program: both what it looks like, and how it behaves. In QML, a user interface is specified as a tree of objects with properties. In this tutorial we will show how you can make a simple Hello World application with PySide2 and QML.

A PySide2/QML application consists, at least, of two different files - a file with the QML description of the user interface, and a python file which loads the qml file. To avoid problems for now, don't forget to save both files in the same directory.

Here is a simple QML file, called view.qml:

import QtQuick 2.0

Rectangle {
 width: 200
 height: 200
 color: "green"

Text {
 text: "Hello World"
 anchors.centerIn: parent
 }
}

We start by importing QtQuick 2.0, which a separate Qt module.

The rest of the QML code is pretty straightforward for those who have previously used HTML or XML files. Basically, we are creating a green rectangle with the size 200*200 and, inside that rectangle, we are adding a Text element which says Hello World. The code anchors.centerIn: parent just makes the text appear centered in relation to its immediate parent.

Now, let's see how the code looks on the PySide2. Let's call it main.py:

from PySide2.QtWidgets import QApplication
from PySide2.QtQuick import QQuickView
from PySide2.QtCore import QUrl

app = QApplication([])
view = QQuickView()
url = QUrl("view.qml")

view.setSource(url)
view.show()
app.exec_()


If you are already familiar with PySide2 and have followed our tutorials, much of this code is already familiar. The only novelties are that you must import QtQuick and set the source of the QQuickView object to the URL of your QML file. Then, as any Qt widget, you call QQuickView.show().

Hint: If you are programming for desktop, you should consider adding view.setResizeMode(QQuickView.SizeRootObjectToView) before showing the view.

This will force the outer QML rectangle to resize along with the outer window.