QMessageContentContainer Class Reference

Detailed Description

The QMessageContentContainer class provides an interface for internet media (MIME) and Transport Neutral Encapsulation Format (TNEF) content that is possibly only partially retrieved.

A QMessageContentContainer object can either directly contain media such as text, image, audio, video, application or message data, or contain multiple parts of content, but can not contain both media and multiple parts directly.

Container objects can be obtained via their QMessageContentContainerId identifier, using the find() function of the containing QMessage object.

For textual content using a recognized charset encoding textContent() will return the content as a unicode string.

For non-multipart content content() will return the content data after decoding any transfer encoding used to represent binary data using 7-bit ASCII characters, such as quoted-printable and base64.

The internet media (MIME) type of the container is returned by contentType(), the content subtype is returned by contentSubType(), the content type charset parameter is returned by contentCharset(), and the content suggested filename by suggestedFileName().

The type of a container that contains multiple parts of content must be "multipart" (case insensitive). A list of identifiers for directly contained parts of content is returned by contentIds().

An indication of the size of the container and its contents on the originating server is given by size(). If the content is entirely available on the device isContentAvailable() will return true.

Non-multipart content can be serialized to a QDataStream using writeContentTo(), or to a QTextStream using writeTextContentTo().

A container also stores name-value pairs known as header fields. Names are ASCII strings, while values are charset encoded unicode strings. A list of the header fields present in a container is returned by headerFields(). The unicode string values associated with a particular header field name are returned by headerFieldValues().

See also QMessage and QMessageContentContainerId.

Member Function Documentation