QLandmark Class Reference

Member Function Documentation

QLandmark::QLandmark ()

Constructs an new landmark.

A new landmark will be assigned with invalid QLandmarkId.

QLandmark::QLandmark ( const QGeoPlace & other )

Constructs a new landmark from other.

If other is not a landmark, the coordinates, address and viewport get copied into the newly created landmark.

If other is a landmark, this function is equivalent to calling QLandmark(const QLandmark &other).

This constructor allows (1) and c to take place. /code QGeoPlace geoPlace = lm1; //lm1 is a QLandmark ... QLandmark lm2 = geoPlace; //(1)lm2 is equivalent to lm1

QGeoPlace ordinaryPlace; QLandmark lm3 = ordinarPlace; //(2)lm3 has the details of ordinaryPlace's coordinate, address and viewport. /endcode

This function was introduced in Qt Mobility 1.1.

QLandmark::QLandmark ( const QLandmark & other )

Constructs a copy of other.

This function was introduced in Qt Mobility 1.1.

QLandmark::~QLandmark ()

Destroys the landmark.

void QLandmark::addCategoryId ( const QLandmarkCategoryId & categoryId )

Adds another category that this landmark will be associated with via its categoryId.

This function was introduced in Qt Mobility 1.1.

See also setCategoryIds() and removeCategoryId().

QList<QLandmarkCategoryId> QLandmark::categoryIds () const

Returns a of list identifiers of categories that this landmark belongs to.

This function was introduced in Qt Mobility 1.1.

See also setCategoryIds().

void QLandmark::clear ()

Clears all the data fields of the landmark.

This function was introduced in Qt Mobility 1.1.

QString QLandmark::description () const

Returns a description of the landmark.

This function was introduced in Qt Mobility 1.1.

See also setDescription().

QUrl QLandmark::iconUrl () const

Returns the url of the landmark's icon.

This function was introduced in Qt Mobility 1.1.

See also setIconUrl().

QLandmarkId QLandmark::landmarkId () const

Returns the identifier of the landmark.

This function was introduced in Qt Mobility 1.1.

See also setLandmarkId().

QString QLandmark::name () const

Returns the name of the landmark.

This function was introduced in Qt Mobility 1.1.

See also setName().

QString QLandmark::phoneNumber () const

Returns the phone number of the landmark.

This function was introduced in Qt Mobility 1.1.

See also setPhoneNumber().

qreal QLandmark::radius () const

Returns the coverage radius of the landmark. The unit of the radius is meters.

The coverage radius is relevant for large landmarks such as cities. Note that landmark searches over a given area do not factor in the coverage radius.

This function was introduced in Qt Mobility 1.1.

See also setRadius().

void QLandmark::removeCategoryId ( const QLandmarkCategoryId & categoryId )

Removes a category from a landmark, by using its categoryId.

This function was introduced in Qt Mobility 1.1.

See also addCategoryId() and categoryIds().

void QLandmark::setCategoryIds ( const QList<QLandmarkCategoryId> & categoryIds )

Sets the categories that this landmark belongs to via a list of categoryIds.

This function was introduced in Qt Mobility 1.1.

See also categoryIds(), addCategoryId(), and removeCategoryId().

void QLandmark::setDescription ( const QString & description )

Sets the description of the landmark.

Using the default manager on the Symbian platform, the description is restricted to a length of 4096 characters.

This function was introduced in Qt Mobility 1.1.

See also description().

void QLandmark::setIconUrl ( const QUrl & url )

Sets the url of the landmark's icon.

This function was introduced in Qt Mobility 1.1.

See also iconUrl().

void QLandmark::setLandmarkId ( const QLandmarkId & id )

Sets the id of the landmark.

Note that saving a new landmark using a QLandmarkManager will automatically assign the landmark a valid identifier.

This function was introduced in Qt Mobility 1.1.

See also landmarkId().

void QLandmark::setName ( const QString & name )

Sets the name of the landmark.

Using the default manager on the Symbian platform, the name is restricted to a length of 256 characters.

This function was introduced in Qt Mobility 1.1.

See also name().

void QLandmark::setPhoneNumber ( const QString & phoneNumber )

Sets the phoneNumber of the landmark.

This function was introduced in Qt Mobility 1.1.

See also phoneNumber().

void QLandmark::setRadius ( qreal radius )

Sets the coverage radius of the landmark. The unit of the radius is meters.

This function was introduced in Qt Mobility 1.1.

See also radius().

void QLandmark::setUrl ( const QUrl & url )

Sets the url of the landmark.

This function was introduced in Qt Mobility 1.1.

See also url().

QUrl QLandmark::url () const

Returns the url of the landmark.

This function was introduced in Qt Mobility 1.1.

See also setUrl().

bool QLandmark::operator!= ( const QLandmark & other ) const

Returns true if this landmark not is equal to other, otherwise returns false.

This function was introduced in Qt Mobility 1.1.

See also operator==().

QLandmark & QLandmark::operator= ( const QLandmark & other )

Assigns other to this landmark and returns a reference to this landmark.

This function was introduced in Qt Mobility 1.1.

bool QLandmark::operator== ( const QLandmark & other ) const

Returns true if this landmark is equal to other, otherwise returns false.

Two landmarks are considered equal if both the landmark details and identifiers are equal.

This function was introduced in Qt Mobility 1.1.

See also operator!=().