QPlace Class

if(place.contactTypes().contains(QPlaceContactDetail::Phone)) {
    for(constQPlaceContactDetail&number: place.contactDetails(QPlaceContactDetail::Phone))
        qDebug() << number.label() << ":" << number.value();
}

if(place.extendedAttributeTypes().contains(QPlaceAttribute::OpeningHours))
    qDebug() << place.extendedAttribute(QPlaceAttribute::OpeningHours).text();

成员函数文档

QPlace::QPlace()

创建一个空的场所对象。

[protected] QPlace::QPlace(const QSharedDataPointer<QPlacePrivate> &dd)

使用 `dd ` 作为私有实现来构建一个位置对象。

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

创建other 的副本。

[constexpr noexcept default] QPlace::QPlace(QPlace &&other)

通过Move构造一个QPlace 实例。

[noexcept] QPlace::~QPlace()

把这地方彻底毁了。

void QPlace::appendContactDetail(const QString &contactType, const QPlaceContactDetail &detail)

向指定contactType 添加联系人detail 。

有关常见contact types 的列表，请参见QPlaceContactDetail 。

QString QPlace::attribution() const

返回该地点的富文本来源标注字符串。请注意，某些提供商可能要求，每当向最终用户显示该地点时，都必须显示来源标注。

另请参阅 setAttribution()。

QList<QPlaceCategory> QPlace::categories() const

返回该地点所属的类别。

另请参阅 setCategories()。

QList<QPlaceContactDetail> QPlace::contactDetails(const QString &contactType) const

返回指定contactType 的联系信息列表。

有关常见contact types 的列表，请参阅QPlaceContactDetail 。

另请参阅 setContactDetails()。

QStringList QPlace::contactTypes() const

返回该地点的联系方式类型。

有关常见的contact types 列表，请参阅QPlaceContactDetail 。

QPlaceContent::Collection QPlace::content(QPlaceContent::Type type) const

返回与某个位置相关联的内容集合。该集合是一个映射，其键为内容对象的索引，值为内容对象本身。

type 指定要检索的内容类型。

另请参阅 setContent()。

bool QPlace::detailsFetched() const

如果已获取该地点的详细信息，则返回 true；否则返回 false。

另请参阅 setDetailsFetched()。

QPlaceAttribute QPlace::extendedAttribute(const QString &attributeType) const

返回与指定的attributeType 对应的扩展属性。如果该位置不具备该特定属性类型，则返回一个默认构造的QPlaceExtendedAttribute。

另请参阅 setExtendedAttribute()。

QStringList QPlace::extendedAttributeTypes() const

返回该地点拥有的扩展属性的类型。

QPlaceIcon QPlace::icon() const

返回该地点的图标。

另请参阅 setIcon()。

void QPlace::insertContent(QPlaceContent::Type type, const QPlaceContent::Collection &content)

将给定type 的content 集合添加到该位置。content 中已存在的任何索引都将被覆盖。

bool QPlace::isEmpty() const

返回一个布尔值，用于指示该位置的所有字段是否均为空。

QGeoLocation QPlace::location() const

返回该地点的位置。

另请参阅 ` setLocation()`。

QString QPlace::name() const

返回该地点的名称。

另请参阅 setName()。

QString QPlace::placeId() const

返回该位置的标识符。该位置标识符仅对生成它的QPlaceManager 具有意义，且无法在不同管理器之间转移。该位置标识符不保证在全局范围内唯一，但在生成它的管理器范围内是唯一的。

另请参阅 setPlaceId()。

QString QPlace::primaryEmail() const

返回该地点的主电子邮件地址。此便捷函数会访问email type 对象中的第一个联系人详细信息。如果不存在任何电子邮件地址，则返回空字符串。

QString QPlace::primaryFax() const

返回该地点的主要传真号码。此便捷函数会获取fax type 中的第一个联系信息。如果不存在传真信息，则返回空字符串。

QString QPlace::primaryPhone() const

返回该地点的主要电话号码。此方法将访问phone number type 中的第一个联系信息。如果不存在电话信息，则返回空字符串。

QUrl QPlace::primaryWebsite() const

返回该地点的主要网站。此便捷函数会获取website type 中的首个联系信息。如果不存在任何网站，则返回空字符串。

QPlaceRatings QPlace::ratings() const

返回该地点的综合评分。

另请参阅 setRatings()。

void QPlace::removeContactDetails(const QString &contactType)

删除指定contactType 的所有联系信息。

调用QPlace::contactTypes()时，将不再返回该contactType 。

void QPlace::removeExtendedAttribute(const QString &attributeType)

从该位置移除attributeType 的属性。

该属性将不再由QPlace::extendedAttributeTypes() 列出

void QPlace::setAttribution(const QString &attribution)

设置该位置的attribution 字符串。

另请参阅 attribution()。

void QPlace::setCategories(const QList<QPlaceCategory> &categories)

设置该地点所属的categories 。

另请参阅 categories()。

void QPlace::setCategory(const QPlaceCategory &category)

设置该位置所属的单个category 。

void QPlace::setContactDetails(const QString &contactType, QList<QPlaceContactDetail> details)

设置指定contactType 的联系人details 。

如果details 为空，则该contactType 将从该位置移除，从而QPlace::contactTypes() 不再返回该项。

有关常见contact types 的列表，请参阅QPlaceContactDetail 。

另请参阅 contactDetails()。

void QPlace::setContent(QPlaceContent::Type type, const QPlaceContent::Collection &content)

为给定的type 设置一组content 。

另请参阅 content()。

void QPlace::setDetailsFetched(bool fetched)

用于设置该地点的详细信息是否已被fetched 处理过。

另请参阅 detailsFetched()。

void QPlace::setExtendedAttribute(const QString &attributeType, const QPlaceAttribute &attribute)

将指定attributeType 的attribute 分配给某个位置。如果该位置中已存在attributeType ，则将其覆盖。

如果attribute 是默认构造的QPlaceAttribute ，则会从该位置移除attributeType ，这意味着它将不会被QPlace::extendedAttributeTypes()列出。

另请参阅 extendedAttribute()。

void QPlace::setIcon(const QPlaceIcon &icon)

设置该地点的icon 。

另请参阅 icon()。

void QPlace::setLocation(const QGeoLocation &location)

设置该地点的location 。

另请参阅 location()。

void QPlace::setName(const QString &name)

设置该地点的name 。

另请参阅 name()。

void QPlace::setPlaceId(const QString &identifier)

设置该地点的identifier 。

另请参阅 placeId()。

void QPlace::setRatings(const QPlaceRatings &rating)

设置该地点的聚合rating 。

另请参阅 ratings()。

void QPlace::setSupplier(const QPlaceSupplier &supplier)

将此地点的供应商设置为supplier 。

另请参阅 supplier()。

void QPlace::setTotalContentCount(QPlaceContent::Type type, int totalCount)

设置指定type 中内容对象的totalCount 。

另请参阅 totalContentCount()。

void QPlace::setVisibility(QLocation::Visibility visibility)

将该地点的可见性设置为“visibility ”。

另请参阅 visibility()。

QPlaceSupplier QPlace::supplier() const

返回该地点的供应商。

另请参阅 setSupplier()。

int QPlace::totalContentCount(QPlaceContent::Type type) const

返回给定type 的内容对象总数。该总数表示管理器/提供商应可提供的对象数量。（与该场所实例当前被分配的对象数量不同）。

负数表示项目总数未知。默认情况下，内容总数设置为 0。

另请参阅 setTotalContentCount()。

QLocation::Visibility QPlace::visibility() const

返回该地点的可见性。

新位置的默认可见性设置为 QtLocatin::Unspecified。如果以“未指定”可见性保存位置，后端会在保存时选择一个合适的默认可见性。

另请参阅 setVisibility()。

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

将other 赋值给该位置，并返回对该位置的引用。