NmApplication *application,

                                                   NmUiEngine &uiEngine)

: XQServiceProvider(emailFullServiceNameMessage, parent),

  mApplication(application),

  mUiEngine(uiEngine),

  mAsyncReqId(0)

    This has the soon to be DEPRICATED three argument interface!!!

    Use viewMessage(QVariant idList, QVariant flags) instead!!!

*/

void NmViewerServiceInterface::viewMessage(QVariant mailboxId,

                                           QVariant folderId,

                                           QVariant messageId)

{

    QVariantList idList;

    idList.append(mailboxId);

    idList.append(folderId);

    idList.append(messageId);

    QVariant idListAsVariant = QVariant::fromValue(idList);

    viewMessage(idListAsVariant, QVariant());

}

/*!

    Opens the message view according to the given IDs.

    \param idList A list containing the required IDs for locating the wanted

                  message. The ID are the following (and should be placed in

                  the following order): mailbox ID, folder ID and message ID.

    \param flags Will contain EmailBackReturnsToMessageList if the message

                 list view should be added into the view stack.

*/

void NmViewerServiceInterface::viewMessage(QVariant idList, QVariant flags)

    NmId mailboxId(0), folderId(0), messageId(0);

    // Check the given arguments.

    if (idList.canConvert(QVariant::List)) {

        QList<QVariant> ids = idList.toList();

        if (ids.count() >= 3) {

            mailboxId = ids[0].toULongLong();

            folderId = ids[1].toULongLong();

            messageId = ids[2].toLongLong();

        }

    }

    quint64 flag(EmailNoFlags);

    if (flags.canConvert(QVariant::ULongLong)) {

        flag = flags.toULongLong();

    }

    bool addMessageListViewToStack(false);

    if (flag & EmailBackReturnsToMessageList) {

        addMessageListViewToStack = true;

    }

	// Make sure the app stays on the background if the user presses back button

    // in the viewer view.

    NmMessage *message = mUiEngine.message(mailboxId, folderId, messageId);

        // Bring the application to the foreground.

        if (addMessageListViewToStack) {

            // Launch the message list view.

            NmUiStartParam *startParam1 = 

                new NmUiStartParam(NmUiViewMessageList,

                                   mailboxId,

                                   folderId,

                                   messageId,

                                   NmUiEditorCreateNew, // editor start mode

                                   NULL, // address list

                                   NULL, // attachment list

                                   true); // start as service

            mApplication->enterNmUiView(startParam1);

        }

                               mailboxId,

                               folderId, // folder id

                               messageId, // message id

                               !addMessageListViewToStack); // start as service?

        completeRequest(mAsyncReqId, 0);

        // The message was not found!

        // If started as embedded, do not hide the app.

        completeRequest(mAsyncReqId, 1);

        // Close the application if started as a service.

            // Exit the application when the return value is delivered.