[QGIS Commit] r10557 - in trunk/qgis/python: core gui

[svn_qgis at osgeo.org]

Author: wonder
Date: 2009-04-13 08:29:59 -0400 (Mon, 13 Apr 2009)
New Revision: 10557

Added:
   trunk/qgis/python/core/qgsrunprocess.sip
   trunk/qgis/python/gui/qgsmaptip.sip
Modified:
   trunk/qgis/python/core/core.sip
   trunk/qgis/python/gui/gui.sip
Log:
PyQGIS: wrapped QgsMapTip and QgsRunProcess.


Modified: trunk/qgis/python/core/core.sip
===================================================================
--- trunk/qgis/python/core/core.sip	2009-04-13 12:28:46 UTC (rev 10556)
+++ trunk/qgis/python/core/core.sip	2009-04-13 12:29:59 UTC (rev 10557)
@@ -57,6 +57,7 @@
 %Include qgsrect.sip
 %Include qgsrendercontext.sip
 %Include qgsrenderer.sip
+%Include qgsrunprocess.sip
 %Include qgsscalecalculator.sip
 %Include qgssinglesymbolrenderer.sip
 %Include qgssnapper.sip

Added: trunk/qgis/python/core/qgsrunprocess.sip
===================================================================
--- trunk/qgis/python/core/qgsrunprocess.sip	                        (rev 0)
+++ trunk/qgis/python/core/qgsrunprocess.sip	2009-04-13 12:29:59 UTC (rev 10557)
@@ -0,0 +1,33 @@
+
+/** \ingroup core
+ * A class that executes an external program/script.
+ * It can optionally capture the standard output and error from the
+ * process and displays them in a dialog box.
+ */
+class QgsRunProcess: QObject
+{
+%TypeHeaderCode
+#include <qgsrunprocess.h>
+%End
+
+  public:
+    // This class deletes itself, so to ensure that it is only created
+    // using new, the Named Consturctor Idiom is used, and one needs to
+    // use the create() static function to get an instance of this class.
+
+    // The action argument contains string with the command.
+    // If capture is true, the standard output and error from the process
+    // will be sent to QgsMessageOuptut - usually a dialog box.
+    static QgsRunProcess* create( const QString& action, bool capture );
+
+  public slots:
+    void stdoutAvailable();
+    void stderrAvailable();
+    void processError( QProcess::ProcessError );
+    void processExit( int, QProcess::ExitStatus );
+    void dialogGone();
+
+  private:
+    QgsRunProcess( const QString& action, bool capture );
+    ~QgsRunProcess();
+};

Modified: trunk/qgis/python/gui/gui.sip
===================================================================
--- trunk/qgis/python/gui/gui.sip	2009-04-13 12:28:46 UTC (rev 10556)
+++ trunk/qgis/python/gui/gui.sip	2009-04-13 12:29:59 UTC (rev 10557)
@@ -15,6 +15,7 @@
 %Include qgsmapcanvasitem.sip
 %Include qgsmapcanvasmap.sip
 %Include qgsmapcanvassnapper.sip
+%Include qgsmaptip.sip
 %Include qgsmaptool.sip
 %Include qgsmaptoolemitpoint.sip
 %Include qgsmaptoolpan.sip

Added: trunk/qgis/python/gui/qgsmaptip.sip
===================================================================
--- trunk/qgis/python/gui/qgsmaptip.sip	                        (rev 0)
+++ trunk/qgis/python/gui/qgsmaptip.sip	2009-04-13 12:29:59 UTC (rev 10557)
@@ -0,0 +1,38 @@
+
+/** \ingroup gui
+ * A maptip is a class to display a tip on a map canvas
+ * when a mouse is hovered over a feature.
+ */
+class QgsMapTip
+{
+%TypeHeaderCode
+#include <qgsmaptip.h>
+%End
+
+  public:
+    /** Default constructor
+     */
+    QgsMapTip();
+    /** Destructor
+     */
+    virtual ~QgsMapTip();
+    /** Show a maptip at a given point on the map canvas
+     * @param QgsMapLayer thepLayer - a qgis vector map layer pointer that will
+     *        be used to provide the attribute data for the map tip.
+     * @param QgsPoint theMapPosition - a reference to the position of the cursor
+     *        in map coordinatess.
+     * @param QgsPoint thePixelPosition - a reference to the position of the cursor
+     *        in pixel coordinates.
+     * @param QgsMapCanvas thepMapCanvas - a map canvas on which the tip is drawn
+     */
+    void showMapTip( QgsMapLayer * thepLayer,
+                     QgsPoint & theMapPosition,
+                     QPoint & thePixelPosition,
+                     QgsMapCanvas *mpMapCanvas );
+    /** Clear the current maptip if it exists
+     * @param QgsMapCanvas mpMapCanvas - the canvas from which the tip should
+     *        be cleared.
+     */
+    void clear( QgsMapCanvas *mpMapCanvas );
+
+};