The QGeoMapTextObject class is a QGeoMapObject used to draw text on a map. More...
#include <QGeoMapTextObject>
Inherits QGeoMapObject.
|
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 |
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 ) |
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.
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 ) |
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 ) |
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 ) |
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 ) |
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 ) |
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 ) |
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 ) |
Constructs a new text object with the parent parent.
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.
Destroys this text object.