QMailNewSystemMessageHandler Class Reference
[QtMessagingModule]

Detailed Description

The QMailNewSystemMessageHandler class provides a convenient interface for responding to new system message arrival notifications emitted by the message server.

When a new system message is retrieved by the message server, the NewSystemMessageArrival::arrived(QDSActionRequest) service request is emitted. If a process registers to handle this request and instantiates a QMailNewSystemMessageHandler object, the handler object will process the service request and emit the newCountChanged() signal.

In response to the newCountChanged() signal, the handler process should invoke the setHandled() slot, to communicate whether or not they have handled the event to the message server. If any handler process reports the event as handled, then the count of new system message messages will be reset, and those messages will have the QMailMessage::New status flag unset.

Note: if a process instantiates a QMailNewSystemMessageHandler, it will not do anything unless the process is also registered to handle the NewSystemMessageArrival service.

Member Function Documentation

QMailNewSystemMessageHandler::QMailNewSystemMessageHandler ( QObject * parent = 0 )

Constructs a new handler for the NewSystemMessageArrival service, with the specified parent.

QMailMessage::MessageType QMailNewSystemMessageHandler::messageType () const   [virtual]

Returns QMailMessage::System, the type of messages handled by QMailNewSystemMessageHandler.

Reimplemented from QMailNewMessageHandler.