PySideSimplicissimus Module 3 AboutBox: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
[[Category:LanguageBindings]]
[[Category:LanguageBindings::PySide::Newbie Tutorials]]


* '''Note:''' this article is a member of the multipart [[PySide-Newbie-Tutorials]]
'''English''' ["French":http://qt-devnet.developpez.com/tutoriels/pyside/simplissimus/2-a-propos/] [[PySideSimplicissimus_Module_3_AboutBox_Japanese|日本語]]
= About Box =
This dialog box shows the version of About Box itself, as well as versions of '''Qt''', '''PySide''' and '''Python''' beeing used, together with the '''platform''' on which the program is being run.
First step is to use '''Qt Designer''' to visually design the main window and add one PushButton. We give the name by Saving As the file '''about.ui''' (ui extension is added by the '''Qt Designer''').
All current source code for "Close", "About", "Show Licence", all versions of "Combined", "Engineering Application" aka "truss" are stored in one repository '''tuts4pyside'''. For your convenience, please install a copy of the repository with the following command:
<code> git clone https://github.com/OldAl/tuts4pyside<code>
If you do not have '''git''', pllease install it first.
View the '''about.ui''' with '''Qt Designer''' at your leisure. The about.ui is an XML file. If you can not read it, do not let it bother you - Python can not read it, either… To make it readable to python we need to process it with a script from pyside-tools package:
</code>
pyside-uic about.ui > ui_about.py
<code>
The Python readable file ui_about.py can now be imported by the program and used as shown in the following code listing
</code>
#!/usr/bin/env python
# about.py - display about box with info on platform etc.
import sys
import platform
import PySide
from PySide.QtGui import QApplication, QMainWindow, QTextEdit, QPushButton, QMessageBox
from ui_about import Ui_MainWindow
''version'' = '0.0.1'
class MainWindow(QMainWindow, Ui_MainWindow):
def ''init''(self, parent=None):
super(MainWindow, self).''init''(parent)
self.setupUi(self)
self.aboutButton.clicked.connect(self.about)
def about(self):
'''Popup a box with about message.'''
QMessageBox.about(self, "About PySide, Platform and the like",
"""<b>Platform Details</b> v %s
<p>Copyright &amp;copy; 2010 Joe Bloggs.
All rights reserved in accordance with
GPL v2 or later - NO WARRANTIES!
<p>This application can be used for
displaying platform details.
<p>Python %s - PySide version %s - Qt version %s on s""" (''version'',
platform.python_version(), PySide.''version'', PySide.QtCore.''version'',
platform.system()))
if ''name'' == '''main''':
app = QApplication(sys.argv)
frame = MainWindow()
frame.show()
app.exec_()
<code>
The main program is right at the end. It mostly follows a common pattern. We call the application '''app''' and pass to it any CLI arguments in '''sys.argv'''. A chosen name for the '''window frame''' is '''frame''', but it could be anything at all. '''frame.show()''' tells the system to show the '''frame''' as soon as the application cycle starts running and finally, app.exec_() starts the application cycle, which enables user interaction by clicking on buttons and the like.
A note about the listing of contents of the text in the about dialog popup box: the character '''copy;''' has been re-interpreted to what it represents in HTML, namely little c with a small circle around it. Actually, in the program it needs to be written just as shown in the previous sentence.
The '''about.py''' can be run the same way as any other Python program. Enjoy!

Revision as of 07:21, 27 February 2015


English ["French":http://qt-devnet.developpez.com/tutoriels/pyside/simplissimus/2-a-propos/] 日本語

About Box

This dialog box shows the version of About Box itself, as well as versions of Qt, PySide and Python beeing used, together with the platform on which the program is being run.

First step is to use Qt Designer to visually design the main window and add one PushButton. We give the name by Saving As the file about.ui (ui extension is added by the Qt Designer).

All current source code for "Close", "About", "Show Licence", all versions of "Combined", "Engineering Application" aka "truss" are stored in one repository tuts4pyside. For your convenience, please install a copy of the repository with the following command:

 git clone https://github.com/OldAl/tuts4pyside<code>
If you do not have '''git''', pllease install it first.

View the '''about.ui''' with '''Qt Designer''' at your leisure. The about.ui is an XML file. If you can not read it, do not let it bother you - Python can not read it, either To make it readable to python we need to process it with a script from pyside-tools package:

pyside-uic about.ui > ui_about.py

The Python readable file ui_about.py can now be imported by the program and used as shown in the following code listing
  1. !/usr/bin/env python
  2. about.py - display about box with info on platform etc.

import sys import platform

import PySide from PySide.QtGui import QApplication, QMainWindow, QTextEdit, QPushButton, QMessageBox

from ui_about import Ui_MainWindow

version = '0.0.1'

class MainWindow(QMainWindow, Ui_MainWindow):

def init(self, parent=None):
super(MainWindow, self).init(parent)
self.setupUi(self)
self.aboutButton.clicked.connect(self.about)

def about(self):

Popup a box with about message.
QMessageBox.about(self, "About PySide, Platform and the like",
"""Platform Details v %s

Copyright &copy; 2010 Joe Bloggs. All rights reserved in accordance with GPL v2 or later - NO WARRANTIES!

This application can be used for displaying platform details.

Python %s - PySide version %s - Qt version %s on s""" (version, platform.python_version(), PySide.version, PySide.QtCore.version, platform.system())) if name == main: app = QApplication(sys.argv) frame = MainWindow() frame.show() app.exec_() The main program is right at the end. It mostly follows a common pattern. We call the application app and pass to it any CLI arguments in sys.argv. A chosen name for the window frame is frame, but it could be anything at all. frame.show() tells the system to show the frame as soon as the application cycle starts running and finally, app.exec_() starts the application cycle, which enables user interaction by clicking on buttons and the like. A note about the listing of contents of the text in the about dialog popup box: the character copy; has been re-interpreted to what it represents in HTML, namely little c with a small circle around it. Actually, in the program it needs to be written just as shown in the previous sentence. The about.py can be run the same way as any other Python program. Enjoy!