|  | Home |

# Messaging Client Utility Library

- Overview
- Message Listing
- Message Composer and Viewer Plugins
- New Message Arrival Service
- Examples

## Overview

The Messaging Framework Messaging Client Utility library provides classes that assist with the development of GUI messaging client applications. The client utility library depends on the Messaging Framework Client Library to provide data access and manipulation classes.

For detailed class information refer to: Messaging Client Utility Classes.

## Message Listing

The Messaging Client Utility library provides classes to assist with displaying lists of message data. Together with the model classes provided by the Messaging Framework Client Library, these classes allow clients to display lists of messages and accounts with minimal effort, and with minimal resource consumption.

Class | Description
--- | ---
QMailMessageDelegate | Provides a standard visual representation of a message in a list view.

## Message Composer and Viewer Plugins

The Messaging Client Utility library uses a plugin system to register components that can compose and view messages. Although this mechanism can be accessed by applications, it is currently recommended that service requests should be used to support message composing and viewing requirements.

Class | Description
--- | ---
QMailComposerFactory | Creates objects implementing the QMailComposerInterface interface
QMailViewerFactory | Creates objects implementing the QMailViewerInterface interface
QMailComposerInterface | Defines the interface to objects that can compose a mail message
QMailViewerInterface | Defines the interface to objects that can display a mail message

## New Message Arrival Service

The Messaging Client Utility library provides services permitting client applications to handle the event of new message arrival.

Each of QMailNewSmsHandler, QMailNewMmsHandler, QMailNewEmailHandler, QMailNewInstantMessageHandler and QMailNewSystemMessageHandler can be instantiated to permit a client application to respond to the arrival of new messages of the relevant type.

## Examples

Name | Description
--- | ---
MessageViewer | Demonstrates the use of QMailMessageMetaData and QMailMessageKey in finding and viewing messages.