QGIS API Documentation  2.7.0-Master
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages
Classes | Public Types | Public Slots | Signals | Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
QgsMapCanvas Class Reference

Map canvas is a class for displaying all GIS data types on a canvas. More...

#include <qgsmapcanvas.h>

Inheritance diagram for QgsMapCanvas:
Inheritance graph
[legend]

Classes

class  CanvasProperties
 

Public Types

enum  WheelAction { WheelZoom, WheelZoomAndRecenter, WheelZoomToMouseCursor, WheelNothing }
 

Public Slots

void layerStateChange ()
 This slot is connected to the visibility change of one or more layers. More...
 
void refresh ()
 Repaints the canvas map. More...
 
bool renderFlag ()
 State of render suppression flag. More...
 
void saveAsImage (QString theFileName, QPixmap *QPixmap=0, QString="PNG")
 Save the convtents of the map canvas to disk as an image. More...
 
void selectionChangedSlot ()
 Receives signal about selection change, and pass it on with layer info. More...
 
void setRenderFlag (bool theFlag)
 Whether to suppress rendering or not. More...
 

Signals

void destinationCrsChanged ()
 Emitted when map CRS has changed. More...
 
void extentsChanged ()
 Emitted when the extents of the map change. More...
 
void hasCrsTransformEnabledChanged (bool flag)
 Emitted when on-the-fly projection has been turned on/off. More...
 
void keyPressed (QKeyEvent *e)
 Emit key press event. More...
 
void keyReleased (QKeyEvent *e)
 Emit key release event. More...
 
void layersChanged ()
 Emitted when a new set of layers has been received. More...
 
void mapCanvasRefreshed ()
 Emitted when canvas finished a refresh request. More...
 
void mapToolSet (QgsMapTool *tool)
 Emit map tool changed event. More...
 
void mapToolSet (QgsMapTool *newTool, QgsMapTool *oldTool)
 Emit map tool changed with the old tool. More...
 
void mapUnitsChanged ()
 Emmitted when map units are changed. More...
 
void renderComplete (QPainter *)
 Emitted when the canvas has rendered. More...
 
void renderStarting ()
 Emitted when the canvas is about to be rendered. More...
 
void rotationChanged (double)
 Emitted when the rotation of the map changes. More...
 
void scaleChanged (double)
 Emitted when the scale of the map changes. More...
 
void selectionChanged (QgsMapLayer *layer)
 Emitted when selection in any layer gets changed. More...
 
Q_DECL_DEPRECATED void setProgress (int, int)
 Let the owner know how far we are with render operations. More...
 
void xyCoordinates (const QgsPoint &p)
 emits current mouse position More...
 
void zoomLastStatusChanged (bool)
 Emitted when zoom last status changed. More...
 
void zoomNextStatusChanged (bool)
 Emitted when zoom next status changed. More...
 

Public Member Functions

 QgsMapCanvas (QWidget *parent=0, const char *name=0)
 Constructor. More...
 
 ~QgsMapCanvas ()
 Destructor. More...
 
bool antiAliasingEnabled () const
 true if antialising is enabled More...
 
virtual QColor canvasColor () const
 Read property of QColor bgColor. More...
 
Q_DECL_DEPRECATED QPaintDevice & canvasPaintDevice ()
 Accessor for the canvas paint device. More...
 
QgsPoint center () const
 Get map center, in geographical coordinates. More...
 
Q_DECL_DEPRECATED void clear ()
 Clear the map canvas. More...
 
void clearCache ()
 Make sure to remove any rendered images from cache (does nothing if cache is not enabled) More...
 
void clearExtentHistory ()
 
QgsMapLayercurrentLayer ()
 returns current layer (set by legend widget) More...
 
void enableAntiAliasing (bool theFlag)
 used to determine if anti-aliasing is enabled or not More...
 
void enableOverviewMode (QgsMapOverviewCanvas *overview)
 
QgsRectangle extent () const
 Returns the current zoom exent of the map canvas. More...
 
void freeze (bool frz=true)
 
QgsRectangle fullExtent () const
 Returns the combined exent for all layers on the map canvas. More...
 
const QgsMapToPixelgetCoordinateTransform ()
 Get the current coordinate transform. More...
 
void getDatumTransformInfo (const QgsMapLayer *ml, const QString &srcAuthId, const QString &destAuthId)
 ask user about datum transformation More...
 
bool hasCrsTransformEnabled ()
 A simple helper method to find out if on the fly projections are enabled or not. More...
 
bool isCachingEnabled () const
 Check whether images of rendered layers are curerently being cached. More...
 
Q_DECL_DEPRECATED bool isDirty () const
 Return the state of the canvas (dirty or not) More...
 
bool isDrawing ()
 Find out whether rendering is in progress. More...
 
bool isFrozen ()
 
bool isParallelRenderingEnabled () const
 Check whether the layers are rendered in parallel or sequentially. More...
 
const QgsLabelingResultslabelingResults () const
 Get access to the labeling results (may be null) More...
 
QgsMapLayerlayer (int index)
 return the map layer at position index in the layer stack More...
 
int layerCount () const
 return number of layers on the map More...
 
QList< QgsMapLayer * > layers () const
 return list of layers within map canvas. More...
 
QgsMapCanvasMapmap ()
 
Q_DECL_DEPRECATED QgsMapRenderermapRenderer ()
 
const QgsMapSettingsmapSettings () const
 Get access to properties used for map rendering. More...
 
QgsMapToolmapTool ()
 Returns the currently active tool. More...
 
QGis::UnitType mapUnits () const
 Get the current canvas map units. More...
 
double mapUnitsPerPixel () const
 Returns the mapUnitsPerPixel (map units per pixel) for the canvas. More...
 
int mapUpdateInterval () const
 Find out how often map preview should be updated while it is being rendered (in milliseconds) More...
 
QPoint mouseLastXY ()
 returns last position of mouse cursor More...
 
void panAction (QMouseEvent *event)
 Called when mouse is moving and pan is activated. More...
 
void panActionEnd (QPoint releasePoint)
 Ends pan action and redraws the canvas. More...
 
void panToSelected (QgsVectorLayer *layer=NULL)
 Pan to the selected features of current (vector) layer keeping same extent. More...
 
QgsPreviewEffect::PreviewMode previewMode () const
 Returns the current preview mode for the map canvas. More...
 
bool previewModeEnabled () const
 Returns whether a preview mode is enabled for the map canvas. More...
 
void readProject (const QDomDocument &)
 called to read map canvas settings from project More...
 
double rotation () const
 Get the current map canvas rotation in clockwise degrees. More...
 
double scale ()
 Get the last reported scale of the canvas. More...
 
void setCachingEnabled (bool enabled)
 Set whether to cache images of rendered layers. More...
 
virtual void setCanvasColor (const QColor &_newVal)
 Write property of QColor bgColor. More...
 
void setCenter (const QgsPoint &center)
 Set the center of the map canvas, in geographical coordinates. More...
 
void setCrsTransformEnabled (bool enabled)
 sets whether to use projections for this layer set More...
 
void setCurrentLayer (QgsMapLayer *layer)
 
void setDestinationCrs (const QgsCoordinateReferenceSystem &crs)
 sets destination coordinate reference system More...
 
Q_DECL_DEPRECATED void setDirty (bool _dirty)
 Flag the canvas as dirty and needed a refresh. More...
 
void setExtent (const QgsRectangle &r)
 Set the extent of the map canvas. More...
 
void setLayerSet (QList< QgsMapCanvasLayer > &layers)
 
void setMapTool (QgsMapTool *mapTool)
 Sets the map tool currently being used on the canvas. More...
 
void setMapUnits (QGis::UnitType mapUnits)
 Set map units (needed by project properties dialog) More...
 
void setMapUpdateInterval (int timeMiliseconds)
 Set how often map preview should be updated while it is being rendered (in milliseconds) More...
 
void setParallelRenderingEnabled (bool enabled)
 Set whether the layers are rendered in parallel or sequentially. More...
 
void setPreviewMode (QgsPreviewEffect::PreviewMode mode)
 Sets a preview mode for the map canvas. More...
 
void setPreviewModeEnabled (bool previewEnabled)
 Enables a preview mode for the map canvas. More...
 
void setRotation (double degrees)
 Set the rotation of the map canvas in clockwise degrees. More...
 
void setSelectionColor (const QColor &color)
 Set color of selected vector features. More...
 
void setWheelAction (WheelAction action, double factor=2)
 set wheel action and zoom factor (should be greater than 1) More...
 
Q_DECL_DEPRECATED void showError (QgsMapLayer *mapLayer)
 
void stopRendering ()
 stop rendering (if there is any right now) More...
 
void unsetMapTool (QgsMapTool *mapTool)
 Unset the current map tool or last non zoom tool. More...
 
Q_DECL_DEPRECATED void updateFullExtent ()
 Updates the full extent. More...
 
Q_DECL_DEPRECATED void updateMap ()
 
void updateOverview ()
 
void updateScale ()
 Emits signal scaleChanged to update scale in main window. More...
 
Q_DECL_DEPRECATED void useImageToRender (bool theFlag)
 Select which Qt class to render with. More...
 
void writeProject (QDomDocument &)
 called to write map canvas settings to project More...
 
void zoomByFactor (double scaleFactor, const QgsPoint *center=0)
 Zoom with the factor supplied. More...
 
void zoomIn ()
 Zoom in with fixed factor. More...
 
void zoomOut ()
 Zoom out with fixed factor. More...
 
void zoomScale (double scale)
 Zoom to a specific scale. More...
 
void zoomToFullExtent ()
 Zoom to the full extent of all layers. More...
 
void zoomToNextExtent ()
 Zoom to the next extent (view) More...
 
void zoomToPreviousExtent ()
 Zoom to the previous extent (view) More...
 
void zoomToSelected (QgsVectorLayer *layer=NULL)
 Zoom to the extent of the selected features of current (vector) layer. More...
 
void zoomWithCenter (int x, int y, bool zoomIn)
 Zooms in/out with a given center. More...
 

Protected Member Functions

void connectNotify (const char *signal)
 debugging member invoked when a connect() is made to this object More...
 
void dragEnterEvent (QDragEnterEvent *e)
 Overridden drag enter event. More...
 
void keyPressEvent (QKeyEvent *e)
 Overridden key press event. More...
 
void keyReleaseEvent (QKeyEvent *e)
 Overridden key release event. More...
 
void mouseDoubleClickEvent (QMouseEvent *e)
 Overridden mouse double click event. More...
 
void mouseMoveEvent (QMouseEvent *e)
 Overridden mouse move event. More...
 
void mousePressEvent (QMouseEvent *e)
 Overridden mouse press event. More...
 
void mouseReleaseEvent (QMouseEvent *e)
 Overridden mouse release event. More...
 
void moveCanvasContents (bool reset=false)
 called when panning is in action, reset indicates end of panning More...
 
void paintEvent (QPaintEvent *e)
 Overridden paint event. More...
 
void resizeEvent (QResizeEvent *e)
 Overridden resize event. More...
 
void updateCanvasItemPositions ()
 called on resize or changed extent to notify canvas items to change their rectangle More...
 
void updateDatumTransformEntries ()
 Make sure the datum transform store is properly populated. More...
 
void wheelEvent (QWheelEvent *e)
 Overridden mouse wheel event. More...
 

Protected Attributes

std::auto_ptr< CanvasPropertiesmCanvasProperties
 Handle pattern for implementation object. More...
 

Detailed Description

Map canvas is a class for displaying all GIS data types on a canvas.

Definition at line 104 of file qgsmapcanvas.h.

Constructor & Destructor Documentation

QgsMapCanvas::QgsMapCanvas ( QWidget *  parent = 0,
const char *  name = 0 
)

Constructor.

Definition at line 183 of file qgsmapcanvas.cpp.

QgsMapCanvas::~QgsMapCanvas ( )

Destructor.

Definition at line 267 of file qgsmapcanvas.cpp.

Member Function Documentation

bool QgsMapCanvas::antiAliasingEnabled ( ) const
inline

true if antialising is enabled

Definition at line 334 of file qgsmapcanvas.h.

QColor QgsMapCanvas::canvasColor ( ) const
virtual

Read property of QColor bgColor.

Definition at line 1513 of file qgsmapcanvas.cpp.

QPaintDevice & QgsMapCanvas::canvasPaintDevice ( )

Accessor for the canvas paint device.

Deprecated:
since 2.4

Definition at line 1563 of file qgsmapcanvas.cpp.

QgsPoint QgsMapCanvas::center ( ) const

Get map center, in geographical coordinates.

Note
added in 2.8

Definition at line 882 of file qgsmapcanvas.cpp.

void QgsMapCanvas::clear ( )

Clear the map canvas.

Deprecated:
since 2.4 - use refresh() - clear does the same thing

Definition at line 917 of file qgsmapcanvas.cpp.

void QgsMapCanvas::clearCache ( )

Make sure to remove any rendered images from cache (does nothing if cache is not enabled)

Note
added in 2.4

Definition at line 562 of file qgsmapcanvas.cpp.

void QgsMapCanvas::clearExtentHistory ( )

Definition at line 975 of file qgsmapcanvas.cpp.

void QgsMapCanvas::connectNotify ( const char *  signal)
protected

debugging member invoked when a connect() is made to this object

Definition at line 1610 of file qgsmapcanvas.cpp.

QgsMapLayer * QgsMapCanvas::currentLayer ( )

returns current layer (set by legend widget)

Definition at line 599 of file qgsmapcanvas.cpp.

void QgsMapCanvas::destinationCrsChanged ( )
signal

Emitted when map CRS has changed.

Note
added in 2.4
void QgsMapCanvas::dragEnterEvent ( QDragEnterEvent *  e)
protected

Overridden drag enter event.

Definition at line 1860 of file qgsmapcanvas.cpp.

void QgsMapCanvas::enableAntiAliasing ( bool  theFlag)

used to determine if anti-aliasing is enabled or not

Definition at line 306 of file qgsmapcanvas.cpp.

void QgsMapCanvas::enableOverviewMode ( QgsMapOverviewCanvas overview)

Definition at line 462 of file qgsmapcanvas.cpp.

QgsRectangle QgsMapCanvas::extent ( ) const

Returns the current zoom exent of the map canvas.

Definition at line 812 of file qgsmapcanvas.cpp.

void QgsMapCanvas::extentsChanged ( )
signal

Emitted when the extents of the map change.

void QgsMapCanvas::freeze ( bool  frz = true)

Freeze/thaw the map canvas. This is used to prevent the canvas from responding to events while layers are being added/removed etc.

Parameters
frzBoolean specifying if the canvas should be frozen (true) or thawed (false). Default is true.

Definition at line 1552 of file qgsmapcanvas.cpp.

QgsRectangle QgsMapCanvas::fullExtent ( ) const

Returns the combined exent for all layers on the map canvas.

Definition at line 817 of file qgsmapcanvas.cpp.

const QgsMapToPixel * QgsMapCanvas::getCoordinateTransform ( )

Get the current coordinate transform.

Definition at line 371 of file qgsmapcanvas.cpp.

void QgsMapCanvas::getDatumTransformInfo ( const QgsMapLayer ml,
const QString &  srcAuthId,
const QString &  destAuthId 
)

ask user about datum transformation

Ask user which datum transform to use.

Definition at line 1776 of file qgsmapcanvas.cpp.

bool QgsMapCanvas::hasCrsTransformEnabled ( )

A simple helper method to find out if on the fly projections are enabled or not.

Definition at line 986 of file qgsmapcanvas.cpp.

void QgsMapCanvas::hasCrsTransformEnabledChanged ( bool  flag)
signal

Emitted when on-the-fly projection has been turned on/off.

Note
added in 2.4
bool QgsMapCanvas::isCachingEnabled ( ) const

Check whether images of rendered layers are curerently being cached.

Note
added in 2.4

Definition at line 557 of file qgsmapcanvas.cpp.

bool QgsMapCanvas::isDirty ( ) const

Return the state of the canvas (dirty or not)

Deprecated:
since 2.4 - dirty flag is not kept anymore - always returns false

Definition at line 356 of file qgsmapcanvas.cpp.

bool QgsMapCanvas::isDrawing ( )

Find out whether rendering is in progress.

Definition at line 363 of file qgsmapcanvas.cpp.

bool QgsMapCanvas::isFrozen ( )

Accessor for frozen status of canvas

Definition at line 1557 of file qgsmapcanvas.cpp.

bool QgsMapCanvas::isParallelRenderingEnabled ( ) const

Check whether the layers are rendered in parallel or sequentially.

Note
added in 2.4

Definition at line 573 of file qgsmapcanvas.cpp.

void QgsMapCanvas::keyPressed ( QKeyEvent *  e)
signal

Emit key press event.

void QgsMapCanvas::keyPressEvent ( QKeyEvent *  e)
protected

Overridden key press event.

Definition at line 1056 of file qgsmapcanvas.cpp.

void QgsMapCanvas::keyReleased ( QKeyEvent *  e)
signal

Emit key release event.

void QgsMapCanvas::keyReleaseEvent ( QKeyEvent *  e)
protected

Overridden key release event.

Definition at line 1165 of file qgsmapcanvas.cpp.

const QgsLabelingResults * QgsMapCanvas::labelingResults ( ) const

Get access to the labeling results (may be null)

Note
added in 2.4

Definition at line 536 of file qgsmapcanvas.cpp.

QgsMapLayer * QgsMapCanvas::layer ( int  index)

return the map layer at position index in the layer stack

Definition at line 330 of file qgsmapcanvas.cpp.

int QgsMapCanvas::layerCount ( ) const

return number of layers on the map

Definition at line 1523 of file qgsmapcanvas.cpp.

QList< QgsMapLayer * > QgsMapCanvas::layers ( ) const

return list of layers within map canvas.

Definition at line 1529 of file qgsmapcanvas.cpp.

void QgsMapCanvas::layersChanged ( )
signal

Emitted when a new set of layers has been received.

void QgsMapCanvas::layerStateChange ( )
slot

This slot is connected to the visibility change of one or more layers.

Definition at line 1542 of file qgsmapcanvas.cpp.

QgsMapCanvasMap * QgsMapCanvas::map ( )
Deprecated:
since 2.4 - there could be more than just one "map" items

Definition at line 319 of file qgsmapcanvas.cpp.

void QgsMapCanvas::mapCanvasRefreshed ( )
signal

Emitted when canvas finished a refresh request.

QgsMapRenderer * QgsMapCanvas::mapRenderer ( )
Deprecated:
since 2.4 - use mapSettings() for anything related to current renderer settings / SIP: removed /Transfer/ because it crashes after few calls to iface.mapCanvas().mapRenderer().hasCrsTransformEnabled() / and in fact there is no transfer of ownership from c++ to python! / Actually the problem comes from the fact that "hasCrsTransformEnabled" is both a signal and a normal method / /KeepReference/ is necessary because otherwise mapRenderer().hasCrsTransformEnabled() was crashing

Definition at line 324 of file qgsmapcanvas.cpp.

const QgsMapSettings & QgsMapCanvas::mapSettings ( ) const

Get access to properties used for map rendering.

Note
added in 2.4

Definition at line 487 of file qgsmapcanvas.cpp.

QgsMapTool * QgsMapCanvas::mapTool ( )

Returns the currently active tool.

Definition at line 1641 of file qgsmapcanvas.cpp.

void QgsMapCanvas::mapToolSet ( QgsMapTool tool)
signal

Emit map tool changed event.

void QgsMapCanvas::mapToolSet ( QgsMapTool newTool,
QgsMapTool oldTool 
)
signal

Emit map tool changed with the old tool.

Note
added in 2.3
QGis::UnitType QgsMapCanvas::mapUnits ( ) const

Get the current canvas map units.

Definition at line 1592 of file qgsmapcanvas.cpp.

void QgsMapCanvas::mapUnitsChanged ( )
signal

Emmitted when map units are changed.

Note
added in 2.4
double QgsMapCanvas::mapUnitsPerPixel ( ) const

Returns the mapUnitsPerPixel (map units per pixel) for the canvas.

Definition at line 1570 of file qgsmapcanvas.cpp.

int QgsMapCanvas::mapUpdateInterval ( ) const

Find out how often map preview should be updated while it is being rendered (in milliseconds)

Note
added in 2.4

Definition at line 583 of file qgsmapcanvas.cpp.

void QgsMapCanvas::mouseDoubleClickEvent ( QMouseEvent *  e)
protected

Overridden mouse double click event.

Definition at line 1197 of file qgsmapcanvas.cpp.

QPoint QgsMapCanvas::mouseLastXY ( )

returns last position of mouse cursor

Definition at line 1687 of file qgsmapcanvas.cpp.

void QgsMapCanvas::mouseMoveEvent ( QMouseEvent *  e)
protected

Overridden mouse move event.

Definition at line 1414 of file qgsmapcanvas.cpp.

void QgsMapCanvas::mousePressEvent ( QMouseEvent *  e)
protected

Overridden mouse press event.

Definition at line 1207 of file qgsmapcanvas.cpp.

void QgsMapCanvas::mouseReleaseEvent ( QMouseEvent *  e)
protected

Overridden mouse release event.

Definition at line 1236 of file qgsmapcanvas.cpp.

void QgsMapCanvas::moveCanvasContents ( bool  reset = false)
protected

called when panning is in action, reset indicates end of panning

Definition at line 1673 of file qgsmapcanvas.cpp.

void QgsMapCanvas::paintEvent ( QPaintEvent *  e)
protected

Overridden paint event.

Definition at line 1303 of file qgsmapcanvas.cpp.

void QgsMapCanvas::panAction ( QMouseEvent *  event)

Called when mouse is moving and pan is activated.

Definition at line 1665 of file qgsmapcanvas.cpp.

void QgsMapCanvas::panActionEnd ( QPoint  releasePoint)

Ends pan action and redraws the canvas.

Definition at line 1646 of file qgsmapcanvas.cpp.

void QgsMapCanvas::panToSelected ( QgsVectorLayer layer = NULL)

Pan to the selected features of current (vector) layer keeping same extent.

Definition at line 1033 of file qgsmapcanvas.cpp.

QgsPreviewEffect::PreviewMode QgsMapCanvas::previewMode ( ) const

Returns the current preview mode for the map canvas.

This setting only has an effect if previewModeEnabled is true.

Returns
preview mode for map canvas
See also
setPreviewMode
previewModeEnabled
Note
added in 2.3

Definition at line 1722 of file qgsmapcanvas.cpp.

bool QgsMapCanvas::previewModeEnabled ( ) const

Returns whether a preview mode is enabled for the map canvas.

Returns
true if a preview mode is currently enabled
See also
setPreviewModeEnabled
previewMode
Note
added in 2.3

Definition at line 1702 of file qgsmapcanvas.cpp.

void QgsMapCanvas::readProject ( const QDomDocument &  doc)

called to read map canvas settings from project

Definition at line 1732 of file qgsmapcanvas.cpp.

void QgsMapCanvas::refresh ( )
slot

Repaints the canvas map.

Definition at line 605 of file qgsmapcanvas.cpp.

void QgsMapCanvas::renderComplete ( QPainter *  )
signal

Emitted when the canvas has rendered.

Passes a pointer to the painter on which the map was drawn. This is useful for plugins that wish to draw on the map after it has been rendered. Passing the painter allows plugins to work when the map is being rendered onto a pixmap other than the mapCanvas own pixmap member.TODO: deprecate when decorations are reimplemented as map canvas items

  • anything related to rendering progress is not visible outside of map canvas
  • additional drawing shall be done directly within the renderer job or independently as a map canvas item
bool QgsMapCanvas::renderFlag ( )
inlineslot

State of render suppression flag.

Definition at line 398 of file qgsmapcanvas.h.

void QgsMapCanvas::renderStarting ( )
signal

Emitted when the canvas is about to be rendered.

void QgsMapCanvas::resizeEvent ( QResizeEvent *  e)
protected

Overridden resize event.

Definition at line 1279 of file qgsmapcanvas.cpp.

double QgsMapCanvas::rotation ( ) const

Get the current map canvas rotation in clockwise degrees.

Note
added in 2.8

Definition at line 889 of file qgsmapcanvas.cpp.

void QgsMapCanvas::rotationChanged ( double  )
signal

Emitted when the rotation of the map changes.

Note
added in 2.8
void QgsMapCanvas::saveAsImage ( QString  theFileName,
QPixmap *  QPixmap = 0,
QString  theFormat = "PNG" 
)
slot

Save the convtents of the map canvas to disk as an image.

Definition at line 759 of file qgsmapcanvas.cpp.

double QgsMapCanvas::scale ( )

Get the last reported scale of the canvas.

Definition at line 345 of file qgsmapcanvas.cpp.

void QgsMapCanvas::scaleChanged ( double  )
signal

Emitted when the scale of the map changes.

void QgsMapCanvas::selectionChanged ( QgsMapLayer layer)
signal

Emitted when selection in any layer gets changed.

void QgsMapCanvas::selectionChangedSlot ( )
slot

Receives signal about selection change, and pass it on with layer info.

Definition at line 1852 of file qgsmapcanvas.cpp.

void QgsMapCanvas::setCachingEnabled ( bool  enabled)

Set whether to cache images of rendered layers.

Note
added in 2.4

Definition at line 541 of file qgsmapcanvas.cpp.

void QgsMapCanvas::setCanvasColor ( const QColor &  theColor)
virtual

Write property of QColor bgColor.

Definition at line 1495 of file qgsmapcanvas.cpp.

void QgsMapCanvas::setCenter ( const QgsPoint center)

Set the center of the map canvas, in geographical coordinates.

Note
added in 2.8

Definition at line 869 of file qgsmapcanvas.cpp.

void QgsMapCanvas::setCrsTransformEnabled ( bool  enabled)

sets whether to use projections for this layer set

Note
added in 2.4

Definition at line 492 of file qgsmapcanvas.cpp.

void QgsMapCanvas::setCurrentLayer ( QgsMapLayer layer)

Definition at line 340 of file qgsmapcanvas.cpp.

void QgsMapCanvas::setDestinationCrs ( const QgsCoordinateReferenceSystem crs)

sets destination coordinate reference system

Note
added in 2.4

Definition at line 506 of file qgsmapcanvas.cpp.

void QgsMapCanvas::setDirty ( bool  _dirty)

Flag the canvas as dirty and needed a refresh.

Deprecated:
since 2.4 - use refresh() to trigger a refresh (clients should not decide explicitly whether canvas is dirty or not)

Definition at line 350 of file qgsmapcanvas.cpp.

void QgsMapCanvas::setExtent ( const QgsRectangle r)

Set the extent of the map canvas.

Definition at line 823 of file qgsmapcanvas.cpp.

void QgsMapCanvas::setLayerSet ( QList< QgsMapCanvasLayer > &  layers)

Definition at line 376 of file qgsmapcanvas.cpp.

void QgsMapCanvas::setMapTool ( QgsMapTool mapTool)

Sets the map tool currently being used on the canvas.

Definition at line 1440 of file qgsmapcanvas.cpp.

void QgsMapCanvas::setMapUnits ( QGis::UnitType  mapUnits)

Set map units (needed by project properties dialog)

Definition at line 1576 of file qgsmapcanvas.cpp.

void QgsMapCanvas::setMapUpdateInterval ( int  timeMiliseconds)

Set how often map preview should be updated while it is being rendered (in milliseconds)

Note
added in 2.4

Definition at line 578 of file qgsmapcanvas.cpp.

void QgsMapCanvas::setParallelRenderingEnabled ( bool  enabled)

Set whether the layers are rendered in parallel or sequentially.

Note
added in 2.4

Definition at line 568 of file qgsmapcanvas.cpp.

void QgsMapCanvas::setPreviewMode ( QgsPreviewEffect::PreviewMode  mode)

Sets a preview mode for the map canvas.

This setting only has an effect if previewModeEnabled is true.

Parameters
modepreview mode for the canvas
See also
previewMode
setPreviewModeEnabled
previewModeEnabled
Note
added in 2.3

Definition at line 1712 of file qgsmapcanvas.cpp.

void QgsMapCanvas::setPreviewModeEnabled ( bool  previewEnabled)

Enables a preview mode for the map canvas.

Parameters
previewEnabledset to true to enable a preview mode
See also
setPreviewMode
Note
added in 2.3

Definition at line 1692 of file qgsmapcanvas.cpp.

Q_DECL_DEPRECATED void QgsMapCanvas::setProgress ( int  ,
int   
)
signal

Let the owner know how far we are with render operations.

Deprecated:
since 2.4 - already unused in 2.0 anyway
void QgsMapCanvas::setRenderFlag ( bool  theFlag)
slot

Whether to suppress rendering or not.

Definition at line 1598 of file qgsmapcanvas.cpp.

void QgsMapCanvas::setRotation ( double  degrees)

Set the rotation of the map canvas in clockwise degrees.

Note
added in 2.8

Definition at line 894 of file qgsmapcanvas.cpp.

void QgsMapCanvas::setSelectionColor ( const QColor &  color)

Set color of selected vector features.

Note
added in 2.4

Definition at line 1518 of file qgsmapcanvas.cpp.

void QgsMapCanvas::setWheelAction ( WheelAction  action,
double  factor = 2 
)

set wheel action and zoom factor (should be greater than 1)

Definition at line 1381 of file qgsmapcanvas.cpp.

void QgsMapCanvas::showError ( QgsMapLayer mapLayer)
Deprecated:
since 2.4 - does nothing - errors are reported by different means

Definition at line 1682 of file qgsmapcanvas.cpp.

void QgsMapCanvas::stopRendering ( )

stop rendering (if there is any right now)

Note
added in 2.4

Definition at line 743 of file qgsmapcanvas.cpp.

void QgsMapCanvas::unsetMapTool ( QgsMapTool mapTool)

Unset the current map tool or last non zoom tool.

This is called from destructor of map tools to make sure that this map tool won't be used any more. You don't have to call it manualy, QgsMapTool takes care of it.

Definition at line 1477 of file qgsmapcanvas.cpp.

void QgsMapCanvas::updateCanvasItemPositions ( )
protected

called on resize or changed extent to notify canvas items to change their rectangle

Definition at line 1310 of file qgsmapcanvas.cpp.

void QgsMapCanvas::updateDatumTransformEntries ( )
protected

Make sure the datum transform store is properly populated.

Definition at line 1617 of file qgsmapcanvas.cpp.

Q_DECL_DEPRECATED void QgsMapCanvas::updateFullExtent ( )
inline

Updates the full extent.

Deprecated:
since v2.4 - does nothing

Definition at line 267 of file qgsmapcanvas.h.

void QgsMapCanvas::updateMap ( )
Deprecated:
in 2.4 - does nothing - kept for API compatibility

Definition at line 754 of file qgsmapcanvas.cpp.

void QgsMapCanvas::updateOverview ( )

Definition at line 589 of file qgsmapcanvas.cpp.

void QgsMapCanvas::updateScale ( )

Emits signal scaleChanged to update scale in main window.

Definition at line 911 of file qgsmapcanvas.cpp.

void QgsMapCanvas::useImageToRender ( bool  theFlag)

Select which Qt class to render with.

Deprecated:
since 2.4 - does nothing because now we always render to QImage

Definition at line 314 of file qgsmapcanvas.cpp.

void QgsMapCanvas::wheelEvent ( QWheelEvent *  e)
protected

Overridden mouse wheel event.

Definition at line 1328 of file qgsmapcanvas.cpp.

void QgsMapCanvas::writeProject ( QDomDocument &  doc)

called to write map canvas settings to project

Definition at line 1756 of file qgsmapcanvas.cpp.

void QgsMapCanvas::xyCoordinates ( const QgsPoint p)
signal

emits current mouse position

Note
changed in 1.3
void QgsMapCanvas::zoomByFactor ( double  scaleFactor,
const QgsPoint center = 0 
)

Zoom with the factor supplied.

Factor > 1 zooms out, interval (0,1) zooms in If point is given, re-center on it

Definition at line 1844 of file qgsmapcanvas.cpp.

void QgsMapCanvas::zoomIn ( )

Zoom in with fixed factor.

Definition at line 1387 of file qgsmapcanvas.cpp.

void QgsMapCanvas::zoomLastStatusChanged ( bool  )
signal

Emitted when zoom last status changed.

void QgsMapCanvas::zoomNextStatusChanged ( bool  )
signal

Emitted when zoom next status changed.

void QgsMapCanvas::zoomOut ( )

Zoom out with fixed factor.

Definition at line 1392 of file qgsmapcanvas.cpp.

void QgsMapCanvas::zoomScale ( double  scale)

Zoom to a specific scale.

Definition at line 1397 of file qgsmapcanvas.cpp.

void QgsMapCanvas::zoomToFullExtent ( )

Zoom to the full extent of all layers.

Definition at line 924 of file qgsmapcanvas.cpp.

void QgsMapCanvas::zoomToNextExtent ( )

Zoom to the next extent (view)

Definition at line 958 of file qgsmapcanvas.cpp.

void QgsMapCanvas::zoomToPreviousExtent ( )

Zoom to the previous extent (view)

Definition at line 940 of file qgsmapcanvas.cpp.

void QgsMapCanvas::zoomToSelected ( QgsVectorLayer layer = NULL)

Zoom to the extent of the selected features of current (vector) layer.

Parameters
layeroptionally specify different than current layer

Definition at line 991 of file qgsmapcanvas.cpp.

void QgsMapCanvas::zoomWithCenter ( int  x,
int  y,
bool  zoomIn 
)

Zooms in/out with a given center.

Definition at line 1402 of file qgsmapcanvas.cpp.

Member Data Documentation

std::auto_ptr<CanvasProperties> QgsMapCanvas::mCanvasProperties
protected

Handle pattern for implementation object.

Definition at line 555 of file qgsmapcanvas.h.


The documentation for this class was generated from the following files: