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是可选的参数序列，传递给任何已连接的槽。