Signals and Slots in PySide/ja
PySideのシグナルとスロット
このページではPySideのシグナルとスロットの使い方を説明します。いわゆる新スタイルのシグナルとスロットの使い方を中心に説明しますが、参考として旧スタイルの使い方も合わせて紹介します。
PyQtでは、新スタイルのシグナルとスロットはPyQt v4.5から導入されました。この新スタイルの目的は、PythonプログラマによりPythonicな構文を提供することです。PySideは "PSEP 100":http://www.pyside.org/docs/pseps/psep-0100.html をこの実装のガイドラインとして使用しています。
旧スタイルの方法 SIGNALとSLOT
QtCore.SIGNAL (...) と QtCore.SLOT (...) マクロは、Qtのシグナル／スロット配信機構とPythonをつなぐインタフェースであり、旧スタイルのシグナル／スロットの使い方です。
次の例ではQPushButtonの一般的なシグナルであるclickedシグナルを使用しています。旧スタイルではマクロ経由のシグナルと接続先のスロットをオブジェクトに伝えるため、connectメソッドはpythonに馴染みにくい構文になります。
<br />…
def someFunc():<br /> print "someFunc has been called!"
…
button = QtGui.QPushButton("Call someFunc&quot;)<br />QtCore.QObject.connect(button, QtCore.SIGNAL (&#39;clicked()'), someFunc)
…<br />
新スタイルの方法 Signal（）とSlot（）
新スタイルでは新しい構文を使ってシグナルとスロットを接続します。先ほどの例は次のようにすっきりと書くことができます。
<br />…
def someFunc():<br /> print "someFunc has been called!"
button = QtGui.QPushButton("Call someFunc&quot;)<br />button.clicked.connect(someFunc)
…<br />
QtCore.Signal()の使い方
シグナルは QtCore.Sginal() クラスを使って定義します。シグナルのパラメータとしてPythonとCの型が指定できます。オーバーロードをする場合は、複数のパラメータをタプルやリストを使って指定します。
またクラスはシグナル名を定義する名前付き引数（キーワード引数） name を持っています。キーワード name が未指定の場合、代入先の変数名がシグナル名になります。
以下の例題集で、 QtCore.Signal() の使用例をまとめています。
注：シグナルは QObject を継承したクラス内でのみ定義してください。これにより、シグナル情報がQMetaObjectクラスの構造体に追加されます。
QtCore.Slot()の使い方
スロットの指定やオーバーロードには QtCore.Slot() デコレータを使います。スロットのパラメータ定義は QtCore.Signal() と同じく型を指定します。ただしオーバーロードの場合、 Signal() クラスのようにタプルやリストによるパラメータ指定は行いません。代わりにパラメータ毎に新たなデコレータを定義します。以下の例題でこの違いが明確に分かると思います。
また、キーワード引数も異なります。 Slot() は name 、 result の２つのキーワード引数を受けとります。 result キーワードは返却型を定義し、CとPythonの型を指定できます。 name キーワードは Signal() と同様に、未指定の場合には関数名がスロット名になります。
例題集
以下の例では、PySideのシグナルとスロットの定義、および接続方法を示しています。基本的な例とより複雑な例を示します。
- 次の例は、基本的なHello Worldプログラムです。パラメータを指定せずにシグナルとスロットを接続しています。
<br />#!/usr/bin/env python<br /># <s>'''- coding: utf-8 <s>'''-
<br />import sys<br />from PySide import QtCore, QtGui
<br /># スロットとして使用する関数を定義します<br />def sayHello():<br /> print 'Hello world!'
<br />app = QtGui.QApplication(sys.argv)
<br />button = QtGui.QPushButton('Say hello!')
<br /># clickedシグナルとsayHelloスロットを接続します<br />button.clicked.connect(sayHello)<br />button.show()
<br />sys.exit(app.exec_())<br />
次の例は、引数が追加されたHello Worldプログラムの修正版です。スロットに引数が追加され、さらに新しいシグナルが作成されています。
<br />#!/usr/bin/env python<br />#</s>'''</s> coding: utf-8 <s>'''-
<br />import sys<br />from PySide import QtCore
<br /># 新たなスロットを定義します。このスロットは文字列を受け取り<br /># 名前が「saySomeWords」になります<br />&#64;QtCore.Slot(str)<br />def saySomeWords(words):<br /> print words
<br />class Communicate(QtCore.QObject):<br /> # シグナルをその場で作成し、名前を「speak」とします<br /> speak = QtCore.Signal(str)
<br />someone = Communicate()<br /># シグナルとスロットを接続します<br />someone.speak.connect(saySomeWords)<br /># 「speak」シグナルを送出します<br />someone.speak.emit("Hello everybody!")<br />
次はオーバーロードを行います。前回のプログラムを少し修正して、オーバーロードのデコレータを作ります。
<br />#!/usr/bin/env python<br />#</s>'''- coding: utf-8 <s>'''-
<br />import sys<br />from PySide import QtCore
<br /># Cの「int」とpythonの「str」型を受け取る新たなスロットを定義します<br /># 名前は「saySomething」です<br />&#64;QtCore.Slot(int)<br />&#64;QtCore.Slot(str)<br />def saySomething(stuff):<br /> print stuff
<br />class Communicate(QtCore.QObject):<br /> # ２つの新しいシグナルをその場で作成します<br /> # 「int」と「str」型を持つシグナルです<br /> speakNumber = QtCore.Signal(int)<br /> speakWord = QtCore.Signal(str)
<br />someone = Communicate()<br /># シグナルとスロットを接続します<br />someone.speakNumber.connect(saySomething)<br />someone.speakWord.connect(saySomething)<br /># ２つの「speak」シグナルを送出します<br />someone.speakNumber.emit(10)<br />someone.speakWord.emit("Hello everybody!")<br />
最後の例では、スロットとシグナルをオーバーロードし、複雑な接続と送出を行います。
<br />#!/usr/bin/env python<br />#</s>'''- coding: utf-8 <s>*</s>
import sys<br />from PySide import QtCore
# Cの「int」とpythonの「str」型を受け取る新たなスロットを定義します
# 名前は「saySomething」です<br />&#64;QtCore.Slot(int)<br />&#64;QtCore.Slot(str)<br />def saySomething(stuff):<br /> print stuff
class Communicate(QtCore.QObject):<br /> # オーバーロードのシグナルを作成します<br /> # 「int」と「str」型の２つの型を持つシグナルです<br /> speak = QtCore.Signal((int,), (str,))
someone = Communicate()<br /># シグナルとスロットを接続します。シグナルはデフォルトでは「int」型になります<br /># 「str」型にする場合には接続時に指定する必要があります<br />someone.speak.connect(saySomething)<br />someone.speak[str].connect(saySomething)
# 異なる型を持つ「speak」シグナルを送出します
# デフォルトでは「int」型になり、「str」型を使う場合は明示的に指定します<br />someone.speak.emit(10)<br />someone.speak[str].emit("Hello everybody!")<br />
PyQtとの互換性
PyQtの新スタイルとは、シグナル/スロット関数の命名規則が異なります。新スタイルのPyQtからPySideへの変換は、次のいずれかの方法で修正してください。
<br />from PySide.QtCore import Signal as pyqtSignal<br />from PySide.QtCore import Slot as pyqtSlot<br />
または次のようにします。
<br />QtCore.pyqtSignal = QtCore.Signal<br />QtCore.pyqtSlot = QtCore.Slot<br />