日本語 English French [qt-devnet.developpez.com]

組み合わせる – License, About, Close

この例では、これまでの3つの小さなスクリプトを組み合わせてプログラムを一つ作成します。プログラム名はcombineです。ソースを含む必要な資料は、以下のリンクからダウンロードできます。 http://akabaila.pcug.org.au/pyside-data/http://akabaila.pcug.org.au/pyside-data/combine/

まず最初に Qt Designer を使ってフォームを設計し、 combine.ui ファイルを作成します。メニューバーに File アイテムを追加し、そのサブメニューに Show GPLAboutClose を追加します。Qt Designer付属の接続ツール シグナル/スロットエディタ を使い、ドロップダウンメニューから、Sender:action_CloseとSignlal:triggered、 Receiver:MainWindowとSlot:close()を選択します。

Qtでは、クリックやアクションによって発生する シグナル に、関連付けたいアクションを接続します。シグナルの受信側は スロット と呼びます。通常、GUIの設計は付属の標準シグナルを使って行います。 triggered はこうした標準シグナルの一つです。

シグナルはスロットと接続されます。この例題ではシグナルと、プログラムを終了するMainWindowのcloseスロットを接続していますが、PySideではシグナルとPythonメソッドとの接続もできます。

フォームをcombine.uiとして保存した後、以下のようにPythonで読める形式に変換します。

  1. pyside-uic combine.ui > ui_combine.py

このui_combine.pyはPythonだけでなく、人間も読解できます。以下のコードでこのプログラムの使い方を学びましょう。

  1. #!/usr/bin/env python
  2. # combine.py - combination of ShowGPL, About, Close scripts
  3.  
  4. import sys
  5. import platform
  6.  
  7. import PySide
  8. from PySide.QtGui import QApplication, QMainWindow, QTextEdit,\
  9.                          QPushButton,  QMessageBox
  10.  
  11. __version__ = '0.0.1'
  12.  
  13. from ui_combine import Ui_MainWindow
  14.  
  15. class MainWindow(QMainWindow, Ui_MainWindow):
  16.     def __init__(self, parent=None):
  17.         super(MainWindow, self).__init__(parent)
  18.         self.setupUi(self)
  19.        
  20. if __name__ == '__main__':
  21.     app = QApplication(sys.argv)
  22.     frame = MainWindow()
  23.     frame.show()
  24.     app.exec_()

約15行ほどの、これから何度も使うことになるお決まりの内容です。勉強のためにプログラムを実行して動作確認をしましょう。プログラムではすべてのメニューアイテムのトリガーをテストできますが、今のところ機能しているのはCloseだけです。次のステップでは、残りのメニューアイテムのコードを追加していきます。

  1. #!/usr/bin/env python
  2. # combine.py - combination of ShowGPL, About, Close scripts
  3. # Copyright note omitted.
  4.  
  5. import sys
  6. import platform
  7.  
  8. import PySide
  9. from PySide.QtGui import QApplication, QMainWindow, QTextEdit,\
  10.                          QPushButton,  QMessageBox
  11.  
  12. __version__ = '0.0.2'
  13. from ui_combine import Ui_MainWindow
  14.  
  15. class MainWindow(QMainWindow, Ui_MainWindow):
  16.     def __init__(self, parent=None):
  17.         super(MainWindow, self).__init__(parent)
  18.         self.setupUi(self)
  19.         self.actionShow_GPL.triggered.connect(self.showGPL)
  20.         self.action_About.triggered.connect(self.about)        
  21.                
  22.     def showGPL(self):
  23.         '''Read and display GPL licence.'''
  24.         self.textEdit.setText(open('COPYING.txt').read())
  25.        
  26.     def about(self):
  27.         '''Popup a box with about message.'''
  28.         QMessageBox.about(self, "About PyQt, Platform and the like",
  29.                 """<b> About this program </b> v %s
  30.                <p>Copyright 2010 Joe Bloggs.
  31.                All rights reserved in accordance with
  32.                GPL v2 or later - NO WARRANTIES!
  33.                <p>This application can be used for
  34.                displaying OS and platform details.
  35.                <p>Python %s -  PySide version %s - Qt version %s on %s""" % \
  36.                 (__version__, platform.python_version(), PySide.__version__,\
  37.                  PySide.QtCore.__version__, platform.system()))      
  38.        
  39. if __name__ == '__main__':
  40.     app = QApplication(sys.argv)
  41.     frame = MainWindow()
  42.     frame.show()
  43.     app.exec_()

about と showGPL メソッドを追加して、次の構文でシグナルと接続します。
  1.         self.actionShow_GPL.triggered.connect(self.showGPL)
  2.         self.action_About.triggered.connect(self.about)        

これでプログラムの機能は完全になりました。やりましたね。では次の仕事にとりかかりましょう。我々のGUIはまだ見た目がぱっとしません。優れたGUIはメニューの代替手段となる、ボタンやアイコンツールバーを持っているものです。またマウスポインタがアイコン上に移動したときに、機能のヒントやMainWindowフォームのタスクバー上にメッセージを表示すれば一段と素敵になるでしょう。

以上の機能の作成が次の仕事です。

チュートリアルではこれから、アイコン、ポップアップヒント、ステータスバーヒントを備えたツールバーの作成メソッドに取り掛かります。まず必要なのはアイコンです。車輪の再発明をしないように利用可能なアイコンセットを使いましょう。無料の「タンゴのアイコンセット」を以下からダウンロードします。 http://tango.freedesktop.org/Tango_Icon_Library

これはライセンス制約のない、大規模なアイコンのコレクションです。必要とする以上のアイコンがあるので tango_select という名前の小さなライブラリを作り、必要なアイコンをまとめておくとよいでしょう。QtDesignerでcombine.uiを作ったように、テキストエディタ(windowsならNotepad, KDEならkate、Gnomeではgedit)で リソースソースファイル combine.qrcを作ります。一見、黒魔術のようなXMLですが、コピーして簡単に変更できるシンプルな形式です。では中身を見てみましょう。

  1. <!DOCTYPE RCC><RCC version="1.0">
  2. <file alias="quit.png">select_tango/32x32/actions/system-log-out.png</file>
  3. <file alias="about.png">select_tango/32x32/apps/preferences-system-session.png</file>
  4. <file alias="showgpl.png">select_tango/32x32/apps/help-browser.png</file>
  5. </RCC>

たとえば quit アクションのアイコンは、その別名である quit.png としてプログラム中で参照されます。そして実際にはタンゴコレクションの system-log-out.png アイコンが使用されます。では次にcombine.uiと同様に、combine.qrcをコンパイルします。

  1.   pyside-rcc combine.qrc -o qrc_combine.py

qrc_combine.pyファイルは以下のようにプログラムにインポートされます。

  1. #!/usr/bin/env python
  2. # combine.py - combination of ShowGPL, About, Close scripts
  3.  
  4. # Copyright notice removed to save space.
  5.  
  6. import sys
  7. import platform
  8.  
  9. import PySide
  10.                          QMessageBox,  QIcon
  11.  
  12. __version__ = '0.0.3'
  13. from ui_combine import Ui_MainWindow
  14. import qrc_combine
  15.  
  16. class MainWindow(QMainWindow, Ui_MainWindow):
  17.     def __init__(self, parent=None):
  18.         super(MainWindow, self).__init__(parent)
  19.         self.setupUi(self)
  20.         self.actionShow_GPL.triggered.connect(self.showGPL)
  21.         self.action_About.triggered.connect(self.about)        
  22.         iconToolBar = self.addToolBar("iconBar.png")
  23. #------------------------------------------------------
  24. # Add icons to appear in tool bar - step 1
  25.         self.actionShow_GPL.setIcon(QIcon(":/showgpl.png"))
  26.         self.action_About.setIcon(QIcon(":/about.png"))
  27.         self.action_Close.setIcon(QIcon(":/quit.png"))
  28. #------------------------------------------------------
  29. # Show a tip on the Status Bar - step 2
  30.         self.actionShow_GPL.setStatusTip("Show GPL Licence")
  31.         self.action_About.setStatusTip("Pop up the About dialog.")
  32.         self.action_Close.setStatusTip("Close the program.")
  33. #------------------------------------------------------        
  34.         iconToolBar.addAction(self.actionShow_GPL)
  35.         iconToolBar.addAction(self.action_About)
  36.         iconToolBar.addAction(self.action_Close)
  37.        
  38.     def showGPL(self):
  39.         '''Read and display GPL licence.'''
  40.         self.textEdit.setText(open('COPYING.txt').read())
  41.        
  42.     def about(self):
  43.         '''Popup a box with about message.'''
  44.         QMessageBox.about(self, "About PyQt, Platform and the like",
  45.                 """<b> About this program </b> v %s
  46.                <p>Copyright 2010 Joe Bloggs.
  47.                All rights reserved in accordance with
  48.                GPL v2 or later - NO WARRANTIES!
  49.                <p>This application can be used for
  50.                displaying OS and platform details.
  51.                <p>Python %s -  PySide version %s - Qt version %s on %s""" % \
  52.                 (__version__, platform.python_version(), PySide.__version__,\
  53.                  PySide.QtCore.__version__, platform.system()))      
  54.        
  55. if __name__ == '__main__':
  56.     app = QApplication(sys.argv)
  57.     frame = MainWindow()
  58.     frame.show()
  59.     app.exec_()

ステップ1ではアイコン画像をアクションに追加しています。

  1. #------------------------------------------------------
  2. # Add icons to appear in tool bar - step 1
  3.         self.actionShow_GPL.setIcon(QIcon(":/showgpl.png"))
  4.         self.action_About.setIcon(QIcon(":/about.png"))
  5.         self.action_Close.setIcon(QIcon(":/quit.png"))
  6. #------------------------------------------------------

同じように、ステップ2ではヒントのテキストをプログラムに追加しています。
  1. #------------------------------------------------------
  2. # Show a tip on the Status Bar - step 2
  3.         self.actionShow_GPL.setStatusTip("Show GPL Licence")
  4.         self.action_About.setStatusTip("Pop up the About dialog.")
  5.         self.action_Close.setStatusTip("Close the program.")
  6. #------------------------------------------------------

古くから言うように「百聞は一見に如かず」です。完成したcombine.pyのGUIの画像は、以下の外部リポジトリから表示可能です。

ヒント:行を削除するには先頭にハッシュ文字を追加してコメントアウトします。必要に応じて後からハッシュ文字を削除してください

一番必要なのは 楽しむこと です!

チュートリアルのクラスで聞いた話です。ある講師が苦情を訴えに来た初年度の学生の母親に説明しました。「息子さんは、このコースを修了するのに十分な知識が足りなかっただけなんです。彼には一度Pysideを教えました。そして二度目にもです。三度目にはすべてを徹底的に教えました。それで、この私でさえPysideが分かったというのに 、息子さんはまだ分からないのですよ!」

PysideによるGUIプログラミングをよく理解できているといいんですが ー すくなくとも私は :)

Return to PySideSimplicissimus

Categories:

  • PySide Japanese
  •