QGeoMapTextObject Class Reference

 #include <QGeoMapTextObject>

Property Documentation

alignment : Qt::Alignment

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.

Using

 textObject->setAlignment(Qt::AlignLeft | Qt::AlignVCenter);

will place the text so that the point halway up the left edge of the text is at the anchor point defined by QGeoMapTextObject::offset and QGeoMapTextObject::coordinate.

The alignment property is a flag, so using

 textObject->setAlignment(Qt::AlignLeft);

may alter the vertical alignment as well.

The Qt::AlignVertical_Mask and Qt::AlignHorizontal_Mask enum values can be used to alter one component of the alignment independent of the other.

 textObject->setAlignment(Qt::AlignLeft | (textObject->alignment() & Qt::AlignVertical_Mask));

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

This property was introduced in Qt Mobility 1.1.

Access functions:

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

Notifier signal:

void	alignmentChanged ( Qt::Alignment alignment )

brush : QBrush

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.

This property was introduced in Qt Mobility 1.1.

Access functions:

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

Notifier signal:

void	brushChanged ( const QBrush & brush )

coordinate : QGeoCoordinate

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.

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 )

font : QFont

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.

This property was introduced in Qt Mobility 1.1.

Access functions:

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

Notifier signal:

void	fontChanged ( const QFont & font )

offset : QPoint

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).

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 )

pen : QPen

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.

This property was introduced in Qt Mobility 1.1.

Access functions:

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

Notifier signal:

void	penChanged ( const QPen & pen )

text : QString

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

The default value of this property is an empty string.

This property was introduced in Qt Mobility 1.1.

Access functions:

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

Notifier signal:

void	textChanged ( const QString & text )