QPlaceAttribute Class

The QPlaceAttribute class represents generic attribute information about a place. 更多...

头: #include <QPlaceAttribute>
qmake: QT += location

特性

公共函数

QPlaceAttribute ()
QPlaceAttribute (const QPlaceAttribute & other )
~QPlaceAttribute ()
bool isEmpty () const
QString label () const
void setLabel (const QString & label )
void setText (const QString & text )
QString text () const
QPlaceAttribute & operator= (const QPlaceAttribute & other )

静态公共成员

const QString OpeningHours
const QString Payment
const QString Provider
bool operator!= (const QPlaceAttribute & lhs , const QPlaceAttribute & rhs )
bool operator== (const QPlaceAttribute & lhs , const QPlaceAttribute & rhs )

详细描述

A QPlaceAttribute instance stores an additional piece of information about a place that is not otherwise exposed through the QPlace class. A QPlaceAttribute encapsulates a localized label which describes the attribute and rich text string representing the attribute's value. Generally, both are intended to be displayed to the end-user as is.

Some plugins may not support attributes at all, others may only support a certain set, others still may support a dynamically changing set of attributes over time or even allow attributes to be arbitrarily defined by the client application. The attributes could also vary on a place by place basis, for example one place may have opening hours while another does not. Consult the plugin references 了解细节。

Attribute Types

The QPlaceAttribute class defines some constant strings which characterize standard attribute types .

There is a class of attribute types of the format x_id_<provider> for example x_id_here. This class of attributes is a set of alternative identifiers of the place, from the specified provider's perspective.

The above types are used to access and modify attributes in QPlace via:

The attribute type is a string type so that providers are able to introduce new attributes as necessary. Custom attribute types should always be prefixed by a qualifier in order to avoid conflicts.

User Readable and Non-User Readable Attributes

Some attributes may not be intended to be readable by end users, the label field of such attributes are empty to indicate this fact.

特性文档编制

label : QString

This property holds a localized label describing the attribute.

访问函数:

QString label () const
void setLabel (const QString & label )

text : QString

This property holds a piece of rich text representing the attribute value.

访问函数:

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

成员函数文档编制

QPlaceAttribute:: QPlaceAttribute ()

Constructs an attribute.

[noexcept] QPlaceAttribute:: QPlaceAttribute (const QPlaceAttribute & other )

创建副本为 other .

[noexcept] QPlaceAttribute:: ~QPlaceAttribute ()

Destroys the attribute.

bool QPlaceAttribute:: isEmpty () const

Returns a boolean indicating whether the all the fields of the place attribute are empty or not.

[noexcept] QPlaceAttribute &QPlaceAttribute:: operator= (const QPlaceAttribute & other )

赋值 other to this attribute and returns a reference to this attribute.

成员变量文档编制

const QString QPlaceAttribute:: OpeningHours

Specifies the opening hours.

const QString QPlaceAttribute:: Payment

The constant to specify an attribute that defines the methods of payment.

const QString QPlaceAttribute:: Provider

The constant to specify an attribute that defines which provider the place came from.

相关非成员

[noexcept] bool operator!= (const QPlaceAttribute & lhs , const QPlaceAttribute & rhs )

返回 true 若 lhs 不等于 rhs ,否则返回 false。

[noexcept] bool operator== (const QPlaceAttribute & lhs , const QPlaceAttribute & rhs )

返回 true 若 lhs 等于 rhs ,否则返回 false。