aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorHugo Parente Lima <hugo.pl@gmail.com>2011-08-16 14:50:42 -0300
committerHugo Parente Lima <hugo.pl@gmail.com>2012-03-08 16:54:44 -0300
commit48015c2bdc6f602abd7800098e1749fb946cf05a (patch)
treefcf48b5d2dc20011f1535c571b95b5a1f0b5aa33
parent3c7e551a993662623b16fca1c7add077b9ecdd19 (diff)
Fix bug 950 - "implement Q_INVOKABLE"
Reviewer: Marcelo Lira <marcelo.lira@openbossa.org> Renato Ara├║jo <renato.filho@openbossa.org>
-rw-r--r--doc/extras/PySide.QtCore.Slot.rst31
1 files changed, 30 insertions, 1 deletions
diff --git a/doc/extras/PySide.QtCore.Slot.rst b/doc/extras/PySide.QtCore.Slot.rst
index 38654f988..307c2299e 100644
--- a/doc/extras/PySide.QtCore.Slot.rst
+++ b/doc/extras/PySide.QtCore.Slot.rst
@@ -7,4 +7,33 @@ Slot
Detailed Description
--------------------
- PySide adopt PyQt's new signal and slot syntax as-is. The PySide implementation is functionally compatible with the PyQt 4.5 one, with the exceptions listed bellow.
+ PySide adopt PyQt's new signal and slot syntax as-is. The PySide
+ implementation is functionally compatible with the PyQt 4.5 one, with the
+ exceptions listed bellow.
+
+ PyQt's new signal and slot style utilizes method and decorator names
+ specific to their implementation. These will be generalized according to
+ the table below:
+
+ ======= ====================== =============
+ Module PyQt factory function PySide class
+ ======= ====================== =============
+ QtCore pyqtSignal Signal
+ QtCore pyqtSlot Slot
+ ======= ====================== =============
+
+Q_INVOKABLE
+-----------
+
+ PySide doesn't offer something identical to Q_INVOKABLE macro of Qt, the
+ reason is simple, PySide slots can have return values, so if you need to
+ create a invokable method that returns some value, declare it as a slot,
+ e.g.:
+
+ ::
+
+ class Foo(QObject):
+
+ @Slot(result=int, float)
+ def getFloatReturnInt(self, f):
+ return int(f)