MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QGeoMapPixmapObject Class Reference

The QGeoMapPixmapObject class is a QGeoMapObject used to draw a pixmap on a map. More...

 #include <QGeoMapPixmapObject>

Inherits: QGeoMapObject.

This class was introduced in Qt Mobility 1.1.

Properties

Public Functions

QGeoMapPixmapObject ()
QGeoMapPixmapObject ( const QGeoCoordinate & coordinate, const QPoint & offset = QPoint( 0, 0 ), const QPixmap & pixmap = QPixmap() )
~QGeoMapPixmapObject ()
QGeoCoordinate coordinate () const
QPoint offset () const
QPixmap pixmap () const
void setCoordinate ( const QGeoCoordinate & coordinate )
void setOffset ( const QPoint & offset )
void setPixmap ( const QPixmap & pixmap )

Reimplemented Public Functions

virtual QGeoMapObject::Type type () const

Signals

void coordinateChanged ( const QGeoCoordinate & coordinate )
void offsetChanged ( const QPoint & offset )
void pixmapChanged ( const QPixmap & pixmap )

Additional Inherited Members

  • 1 public slot inherited from QObject
  • 1 public variable inherited from QObject
  • 4 static public members inherited from QObject
  • 3 protected functions inherited from QGeoMapObject
  • 7 protected functions inherited from QObject
  • 2 protected variables inherited from QObject

Detailed Description

The QGeoMapPixmapObject class is a QGeoMapObject used to draw a pixmap on a map.

The pixmap object is rendered such that the upper left corner of QGeoMapPixmapObject::pixmap will be drawn QGeoMapPixmapObject::offset pixels away from the position of QGeoMapPixmapObject::coordinate on the map.

Property Documentation

coordinate : QGeoCoordinate

This property holds the coordinate that specifies where the pixmap will be drawn by this pixmap object.

The default value of this property is an invalid coordinate. While the value of this property is invalid the pixmap object will not be displayed.

This property was introduced in Qt Mobility 1.1.

Access functions:

QGeoCoordinate coordinate () const
void setCoordinate ( const QGeoCoordinate & coordinate )

Notifier signal:

void coordinateChanged ( const QGeoCoordinate & coordinate )

offset : QPoint

This property holds the offset in pixels at which the pixmap will be drawn by this pixmap object.

The default value of this property is QPoint(0, 0). If this value is not changed the upper left coordinate of the pixmap will be drawn at the coordinate specified by QGeoMapPixmapObject::coordinate.

The offset is in pixels and is independent of the zoom level of the map. The offset property is provided so that pixmaps such as arrows can be drawn with the point of the arrow placed exactly on the associated coordinate.

This property was introduced in Qt Mobility 1.1.

Access functions:

QPoint offset () const
void setOffset ( const QPoint & offset )

Notifier signal:

void offsetChanged ( const QPoint & offset )

pixmap : QPixmap

This property holds the pixmap that will be drawn by this pixmap object.

The default value of this property is a null pixmap. While the value of this property is the null pixmap the pixmap object will not be displayed.

The pixmap will be drawn such that the upper left corner of the pixmap will be drawn QGeoMapPixmapObject::offset pixels away from the position of QGeoMapPixmapObject::coordinate on the map.

This property was introduced in Qt Mobility 1.1.

Access functions:

QPixmap pixmap () const
void setPixmap ( const QPixmap & pixmap )

Notifier signal:

void pixmapChanged ( const QPixmap & pixmap )

Member Function Documentation

QGeoMapPixmapObject::QGeoMapPixmapObject ()

Constructs a new pixmap object.

QGeoMapPixmapObject::QGeoMapPixmapObject ( const QGeoCoordinate & coordinate, const QPoint & offset = QPoint( 0, 0 ), const QPixmap & pixmap = QPixmap() )

Constructs a new pixmap object which will draw the pixmap pixmap at an offset of offset pixels from the coordinate coordinate.

QGeoMapPixmapObject::~QGeoMapPixmapObject ()

Destroys this pixmap object.

void QGeoMapPixmapObject::coordinateChanged ( const QGeoCoordinate & coordinate ) [signal]

This signal is emitted when the coordinate at which the pixmap should be drawn has changed.

The new value will be coordinate.

This function was introduced in Qt Mobility 1.1.

void QGeoMapPixmapObject::offsetChanged ( const QPoint & offset ) [signal]

This signal is emitted when the on-screen offset from the coordinate at which this pixmap object should be drawn has changed.

The new value will be offset.

This function was introduced in Qt Mobility 1.1.

void QGeoMapPixmapObject::pixmapChanged ( const QPixmap & pixmap ) [signal]

This signal is emitted when the pixmap associated with this pixmap object has changed.

The new value will be pixmap.

This function was introduced in Qt Mobility 1.1.

QGeoMapObject::Type QGeoMapPixmapObject::type () const [virtual]

Reimplemented from QGeoMapObject::type().

This function was introduced in Qt Mobility 1.1.