QPlaceContent Class

The QPlaceContent class holds content about places. 更多...

头：	#include <QPlaceContent>
qmake:	QT += location

所有成员列表，包括继承成员

公共类型

	Collection
enum	DataTag { ContentSupplier, ContentUser, ContentAttribution, ImageId, ImageUrl, …, CustomDataTag }
enum	Type { NoType, ImageType, ReviewType, EditorialType, CustomType }

公共函数

	QPlaceContent (QPlaceContent::Type type = NoType)
	QPlaceContent (const QPlaceContent & other )
	~QPlaceContent ()
QList<QPlaceContent::DataTag>	dataTags () const
void	setValue (QPlaceContent::DataTag tag , const QVariant & value )
QPlaceContent::Type	type () const
QVariant	value (QPlaceContent::DataTag tag ) const
bool	operator!= (const QPlaceContent & other ) const
QPlaceContent &	operator= (const QPlaceContent & other )
bool	operator== (const QPlaceContent & other ) const

详细描述

A QPlaceContent holds rich content such as images, reviews, or editorials, as well as attributes about the content such as the user or supplier of the content. Content objects might hold multiple data, e.g. an item holding a review typically includes the user that wrote the review. Use type () to inspect the type of content a QPlaceContent object represents, and dataTags () to see which data is held. Use value () to get the individual data as a QVariant .

注意： Some providers may require that the attribution string be displayed to the user whenever a piece of content is viewed.

The rich content of a place is typically made available as paginated items.

At present the QPlaceContent class is not extensible by 3rd parties.

Note: The Places API considers content objects to be 'retrieve-only' objects. Submission of content to a provider is not a supported use case.

成员类型文档编制

QPlaceContent:: Collection

同义词 QMap <int, QPlaceContent >. The key of the map is an int representing the index of the content. The value is the content object itself.

The Collection is intended to be a container where content items, that have been retrieved as pages, can be stored. This enables a developer to skip pages, for example indexes 0-9 may be stored in the collection, if the user skips to indexes 80-99, these can be stored in the collection as well.

enum QPlaceContent:: DataTag

Defines the value entry of the content object

常量	值	描述
`QPlaceContent::ContentSupplier`	`0`	The supplier who contributed this content
`QPlaceContent::ContentUser`	`1`	The user who contributed this content
`QPlaceContent::ContentAttribution`	`2`	Returns a rich text attribution string

注意： Some providers may require that the attribution of a particular content item always be displayed when the content item is shown.

常量	值	描述
`QPlaceContent::ImageId`	`3`	The image's identifier
`QPlaceContent::ImageUrl`	`4`	The image's url
`QPlaceContent::ImageMimeType`	`5`	The image's MIME type
`QPlaceContent::EditorialTitle`	`6`	The title of the editorial
`QPlaceContent::EditorialText`	`7`	A textual description of the place. Depending upon the provider, the text could be either rich (HTML based) text or plain text.
`QPlaceContent::EditorialLanguage`	`8`	The language of the editorial. Typically this would be a language code in the 2 letter ISO 639-1 format.
`QPlaceContent::ReviewId`	`9`	The identifier of the review
`QPlaceContent::ReviewDateTime`	`10`	The date and time that the review was submitted
`QPlaceContent::ReviewTitle`	`11`	The title of the review
`QPlaceContent::ReviewText`	`12`	The text of the review. Depending on the provider, the text could be rich (HTML based) or plain text.
`QPlaceContent::ReviewLanguage`	`13`	The language of the review. Typically this would be a language code in the 2 letter ISO 639-1 format.
`QPlaceContent::ReviewRating`	`14`	This review's rating of the place
`QPlaceContent::CustomDataTag`	`1000`

enum QPlaceContent:: Type

Defines the type of content.

常量	值	描述
`QPlaceContent::NoType`	`0`	The content object is default constructed, any other content type may be assigned to this content object
`QPlaceContent::ImageType`	`1`	The content object is an image
`QPlaceContent::ReviewType`	`2`	The content object is a review
`QPlaceContent::EditorialType`	`3`	The content object is an editorial
`QPlaceContent::CustomType`	`0x0100`	The content object is of a custom type

成员函数文档编制

QPlaceContent:: QPlaceContent ( QPlaceContent::Type type = NoType)

Constructs an content object for type .

`[noexcept]` QPlaceContent:: QPlaceContent (const QPlaceContent & other )

Constructs a new copy of other .

`[noexcept]` QPlaceContent:: ~QPlaceContent ()

Destroys the content object.

QList < QPlaceContent::DataTag > QPlaceContent:: dataTags () const

Returns the list of data tags for which values are stored in this content objects.

void QPlaceContent:: setValue ( QPlaceContent::DataTag tag , const QVariant & value )

Sets the value stored for the data tag to value .

另请参阅 value ().

QPlaceContent::Type QPlaceContent:: type () const

Returns the content type.

QVariant QPlaceContent:: value ( QPlaceContent::DataTag tag ) const

Returns the value stored for the data tag ，或无效 QVariant if there is no data for that tag.

另请参阅 setValue ().

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

Returns true if this content object is not equivalent to other ，否则返回 false。

`[noexcept]` QPlaceContent &QPlaceContent:: operator= (const QPlaceContent & other )

赋值 other content object to this and returns a reference to this content object.

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

Returns true if this content object is equivalent to other ，否则返回 false。