PySide QtCore.Signal帮助手册

　　本文主要是翻译了Signal的文档，感兴趣的同学，可以参见 PySide的官方文档。翻译不足之处，还请指正。

　　函数用法

def connect (receiver)
def disconnect (receiver)
def emit (*args)

　　详细描述
　　Signal类提供了使用符合python语法习惯的方法来定义以及连接Qt信号。

　　PySide改造了PyQt的新的信号与槽方法，除了下面提到的特别情况，PySide的实现可以与PyQt 4.5实现功能兼容。

　　使用QtCore.Signal()定义新信号
　　PySide自动为Qt内置的信号定义了信号。使用QtCore.Signal()工厂方法定义新的信号为类的属性。

　　QtCore.Signal()接受若干与信号签名相关的参数类型。每个类型可以是Python类型对象或者C++类型的字符串名称。同时，每个参数可以是类型参数的序列。本例中，每个序列定义了不同信号重载的签名。第一个重载被设置为默认。

　　也可以选择性地提供一个参数 name 给QtCore.Signal()，其值可以设置信号的名称。信号发射时，将使用类属性的名字。

　　下面，显示一系列定义信号的方法:

from PySide import QtCore

class Foo(QtCore.QObject):
# Define a new signal called 'trigger' that has no arguments.
trigger = QtCore.pyqtSignal()

def connect_and_emit_trigger(self):
# Connect the trigger signal to a slot.
self.trigger.connect(self.handle_trigger)

# Emit the signal.
self.trigger.emit()

def handle_trigger(self):
# Show that the slot has been called.
print " trigger signal received "

　　新信号只应该在QObject子类中定义。

　　使用这个方法定义的新信号将会自动添加入类的QMetaObject中。这意味着，它们将在Qt Designer中出现，而且也可以使用QMetaObject API反射获取。

　　连接、断开以及发射信号
　　信号与槽之间可以用Signal.connect()和Signal.disconnect()方法进行连接和断开，或者使用Signal.emit()方法发射信号。

　　下面的代码演示如何定义、连接以及发射没有参数的信号

from PySide import QtCore

class Foo(QtCore.QObject):
# Define a new signal called 'trigger' that has no arguments.
trigger = QtCore.pyqtSignal()

def connect_and_emit_trigger(self):
# Connect the trigger signal to a slot.
self.trigger.connect(self.handle_trigger)

# Emit the signal.
self.trigger.emit()

def handle_trigger(self):
# Show that the slot has been called.
print " trigger signal received "

　　下面则演示连接重载的信号

from PySide import QtGui

class Bar(QtGui.QComboBox):

def connect_activated(self):
# The PyQt documentation will define what the default overload is.
# In this case it is the overload with the single integer argument.
self.activated.connect(self.handle_int)

# For non-default overloads we have to specify which we want to
# connect. In this case the one with the single string argument.
# (Note that we could also explicitly specify the default if we
# wanted to.)
self.activated[str].connect(self.handle_string)

def handle_int(self, index):
print " activated signal passed integer " , index

def handle_string(self, text):
print " activated signal passed string " , text

　　使用关键字参数连接信号
       在创建对象并想连接信号的时候，把槽作为关键字参数的值传递给构造函数。下面的代码实际上是等价的。

act = QtGui.QAction( " Action " , self)
act.triggered.connect(self.on_triggered)

act = QtGui.QAction( " Action " , self, triggered = self.on_triggered)

　　Signal.connect(receiver[, type=Qt.AutoConnection])
　　在singal和receiver之间创立连接，receiver可以是Python函数，或者槽或信号。
　　Signal.disconnect(receiver)
　　断开singal与receiver间的连接。receiver同上。
　　Signal.emit(*args)
　　args是可选的参数序列，传递给任何已连接的槽。