Qt Mobility Reference Documentation

QGeoMapTextObject Class Reference

The QGeoMapTextObject class is a QGeoMapObject used to draw text on a map. More...

 #include <QGeoMapTextObject>

Inherits QGeoMapObject.


Properties


Public Functions

QGeoMapTextObject ( QGeoMapObject * parent = 0 )
QGeoMapTextObject ( const QGeoCoordinate & coordinate, const QString & text = QString(), const QFont & font = QFont(), const QPoint & offset = QPoint(), Qt::Alignment alignment = Qt::AlignCenter, QGeoMapObject * parent = 0 )
~QGeoMapTextObject ()
Qt::Alignment alignment () const
QBrush brush () const
QGeoCoordinate coordinate () const
QFont font () const
QPoint offset () const
QPen pen () const
void setAlignment ( Qt::Alignment alignment )
void setBrush ( const QBrush & brush )
void setCoordinate ( const QGeoCoordinate & coordinate )
void setFont ( const QFont & font )
void setOffset ( const QPoint & offset )
void setPen ( const QPen & pen )
void setText ( const QString & text )
QString text () const

Signals

void alignmentChanged ( Qt::Alignment alignment )
void brushChanged ( const QBrush & brush )
void coordinateChanged ( const QGeoCoordinate & coordinate )
void fontChanged ( const QFont & font )
void offsetChanged ( const QPoint & offset )
void penChanged ( const QPen & pen )
void textChanged ( const QString & text )

Detailed Description

The QGeoMapTextObject class is a QGeoMapObject used to draw text on a map.

The text is drawn at a given coordinate on the map.

The text object is drawn such that the rendered size of the text object is independent of the zoom level of the map.

Note: Anchor and/or alignment options didn't make it into the beta release but will be present in the final 1.1 release.


Property Documentation

alignment : Qt::Alignment

This property holds this property holds the alignment options used to align the text when drawing this text object.

The default value of this property will align the text so that it is centered both horizontally and vertically around the point that is QGeoMapTextObject::offset pixels away from the position of QGeoMapTextObject::coordinate on the screen.

The alignment does not take the width of QGeoMapTextObject::pen into consideration.

Access functions:

Qt::Alignment alignment () const
void setAlignment ( Qt::Alignment alignment )

Notifier signal:

void alignmentChanged ( Qt::Alignment alignment )

brush : QBrush

This property holds this property holds the brush that will be used to draw this object.

The brush is used to fill in the glyphs of the text.

The outline around the perimeter of the glyphs is drawn using the QGeoMapTextObject::pen property.

Access functions:

QBrush brush () const
void setBrush ( const QBrush & brush )

Notifier signal:

void brushChanged ( const QBrush & brush )

coordinate : QGeoCoordinate

This property holds this property holds the coordinate at which this text object will be rendered.

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

If QGeoMapTextObject::offset and QGeoMapTextObject::alignment are not set the text will be drawn so that it is centered both horizontally and vertically around the position of QGeoMapTextObject::coordinate on the screen.

Access functions:

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

Notifier signal:

void coordinateChanged ( const QGeoCoordinate & coordinate )

font : QFont

This property holds this property holds the font that will be used to render the text for this text object.

The default value of this property is the application's default font.

It is not necessary to account for the zoom level of the map, since text objects are scaled such that they appear to be independent of the zoom level.

Access functions:

QFont font () const
void setFont ( const QFont & font )

Notifier signal:

void fontChanged ( const QFont & font )

offset : QPoint

This property holds this property holds the offset in pixels from the screen position of QGeoMapTextObject::coordinate at which the text will be rendered when drawing this text object.

The default value of this property is QPoint(0,0).

Access functions:

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

Notifier signal:

void offsetChanged ( const QPoint & offset )

pen : QPen

This property holds this property holds the pen that will be used to draw this object.

The pen is used to draw an outline around the text. The text itself is filled using the QGeoMapTextObject::brush property.

The pen will be treated as a cosmetic pen, which means that the width of the pen will be independent of the zoom level of the map.

Access functions:

QPen pen () const
void setPen ( const QPen & pen )

Notifier signal:

void penChanged ( const QPen & pen )

text : QString

This property holds this property holds the text that will be displayed by this text object.

The default value of this property is an empty string.

Access functions:

QString text () const
void setText ( const QString & text )

Notifier signal:

void textChanged ( const QString & text )

Member Function Documentation

QGeoMapTextObject::QGeoMapTextObject ( QGeoMapObject * parent = 0 )

Constructs a new text object with the parent parent.

QGeoMapTextObject::QGeoMapTextObject ( const QGeoCoordinate & coordinate, const QString & text = QString(), const QFont & font = QFont(), const QPoint & offset = QPoint(), Qt::Alignment alignment = Qt::AlignCenter, QGeoMapObject * parent = 0 )

Constructs a new text object which will display the text text with font font at the coordinate coordinate on the map, with the parent parent.

QGeoMapTextObject::~QGeoMapTextObject ()

Destroys this text object.

void QGeoMapTextObject::alignmentChanged ( Qt::Alignment alignment ) [signal]

void QGeoMapTextObject::brushChanged ( const QBrush & brush ) [signal]

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

void QGeoMapTextObject::fontChanged ( const QFont & font ) [signal]

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

void QGeoMapTextObject::penChanged ( const QPen & pen ) [signal]

void QGeoMapTextObject::textChanged ( const QString & text ) [signal]

X

Thank you for giving your feedback.

Make sure it is related to this specific page. For more general bugs and requests, please use the Qt Bug Tracker.