/*
* Copyright (c) 2009 - 2010 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description: Message editor view
*
*/
#include "nmuiheaders.h"
// Layout file and view
static const char *NMUI_EDITOR_VIEW_XML = ":/docml/nmeditorview.docml";
static const char *NMUI_EDITOR_VIEW= "editorview";
static const char *NMUI_EDITOR_SCROLL_AREA = "scrollArea";
static const char *NMUI_EDITOR_SCROLL_AREA_CONTENTS = "scrollAreaContents";
static const int NmOrientationTimer=100;
static const QString Delimiter("; ");
/*!
\class NmEditorView
\brief Mail editor view
*/
/*!
Constructor
*/
NmEditorView::NmEditorView(
NmApplication &application,
NmUiStartParam* startParam,
NmUiEngine &uiEngine,
QGraphicsItem *parent)
: NmBaseView(startParam, application, parent),
mApplication(application),
mUiEngine(uiEngine),
mDocumentLoader(NULL),
mScrollArea(NULL),
mEditWidget(NULL),
mHeaderWidget(NULL),
mMessage(NULL),
mContentWidget(NULL),
mAttachmentListContextMenu(NULL),
mMessageCreationOperation(NULL),
mAddAttachmentOperation(NULL),
mRemoveAttachmentOperation(NULL),
mCheckOutboxOperation(NULL),
mWaitDialog(NULL),
mQueryDialog(NULL),
mAttachmentPicker(NULL),
mCcBccFieldVisible(false)
{
mDocumentLoader = new HbDocumentLoader();
// Set object name
setObjectName("NmEditorView");
// Set mailbox name to title pane
setMailboxName();
// Load view layout
loadViewLayout();
}
/*!
Destructor
*/
NmEditorView::~NmEditorView()
{
if (mRemoveAttachmentOperation && mRemoveAttachmentOperation->isRunning()) {
mRemoveAttachmentOperation->cancelOperation();
}
if (mAddAttachmentOperation && mAddAttachmentOperation->isRunning()) {
mAddAttachmentOperation->cancelOperation();
}
if (mMessageCreationOperation && mMessageCreationOperation->isRunning()) {
mMessageCreationOperation->cancelOperation();
}
if (mCheckOutboxOperation && mCheckOutboxOperation->isRunning()) {
mCheckOutboxOperation->cancelOperation();
}
delete mMessage;
mWidgetList.clear();
delete mDocumentLoader;
delete mContentWidget;
delete mPrioritySubMenu;
if (mAttachmentListContextMenu) {
mAttachmentListContextMenu->clearActions();
delete mAttachmentListContextMenu;
}
delete mWaitDialog;
delete mQueryDialog;
delete mAttachmentPicker;
}
/*!
View layout loading from XML
*/
void NmEditorView::loadViewLayout()
{
mPrioritySubMenu = NULL;
// Use document loader to load the view
bool ok = false;
mWidgetList = mDocumentLoader->load(NMUI_EDITOR_VIEW_XML, &ok);
if (ok == true && mWidgetList.count()) {
// Set view
QGraphicsWidget *view = mDocumentLoader->findWidget(NMUI_EDITOR_VIEW);
if (view){
setWidget(view);
}
mScrollArea = qobject_cast<NmBaseViewScrollArea *>
(mDocumentLoader->findObject(NMUI_EDITOR_SCROLL_AREA));
mScrollAreaContents = qobject_cast<HbWidget *>
(mDocumentLoader->findObject(NMUI_EDITOR_SCROLL_AREA_CONTENTS));
mContentWidget = new NmEditorContent(mScrollArea, this, mDocumentLoader,
mApplication.networkAccessManager());
mEditWidget = mContentWidget->editor();
mHeaderWidget = mContentWidget->header();
// Set default color for user - entered text if editor is in re/reAll/fw mode
NmUiEditorStartMode mode = mStartParam->editorStartMode();
if (mode == NmUiEditorReply || mode == NmUiEditorReplyAll || mode == NmUiEditorForward) {
mEditWidget->setCustomTextColor(true, Qt::blue);
}
// the rest of the view initialization is done in viewReady()
}
}
/*!
Reload view contents with new start parameters
Typically when view is already open and external view activation occurs
for this same view
*/
void NmEditorView::reloadViewContents(NmUiStartParam* startParam)
{
// Check start parameter validity.
if (startParam&&startParam->viewId()==NmUiViewMessageEditor) {
// Delete existing start parameter data
delete mStartParam;
mStartParam=NULL;
// Store new start parameter data
mStartParam=startParam;
// Store existing edited message to drafts and reload
// editor with new start parameters.
// ..
// Reload editor with new message data
setMessageData();
}
else {
NMLOG("nmailui: Invalid editor start parameter");
// Unused start parameter needs to be deleted
delete startParam;
startParam = NULL;
}
}
/*!
Screen orientation changed. Editor view needs to be scaled when
landscape <-> portrait switch occurs because text needs to
be wrapped again.
*/
void NmEditorView::orientationChanged(Qt::Orientation orientation)
{
Q_UNUSED(orientation);
// Adjust content height
QTimer::singleShot(NmOrientationTimer, this, SLOT(adjustViewDimensions()));
QTimer::singleShot(NmOrientationTimer, mHeaderWidget, SLOT(sendHeaderHeightChanged()));
}
/*!
Set new dimensions after orientation change.
*/
void NmEditorView::adjustViewDimensions()
{
if (mScrollAreaContents) {
const QSize reso = mApplication.screenSize();
mScrollAreaContents->setMinimumWidth(reso.width());
mScrollAreaContents->setMaximumWidth(reso.width());
}
}
/*!
View id
*/
NmUiViewId NmEditorView::nmailViewId() const
{
return NmUiViewMessageEditor;
}
/*!
ScrollArea contents
*/
HbWidget* NmEditorView::scrollAreaContents()
{
return mScrollAreaContents;
}
/*
Launch dialog for query user if we want to exit the editor
*/
void NmEditorView::okToExitView()
{
NmEditorHeader *header = mContentWidget->header();
bool okToExit = true;
// show the query if the message has not been sent
if (mMessage && header) {
// see if editor has any content
int toTextLength = 0;
if (header->toEdit()) {
toTextLength = header->toEdit()->text().length();
}
int ccTextLength = 0;
if (header->ccEdit()) {
ccTextLength = header->ccEdit()->text().length();
}
int bccTextLength = 0;
if (header->bccEdit()) {
bccTextLength = header->bccEdit()->text().length();
}
int subjectLength = 0;
if (header->subjectEdit()) {
subjectLength = header->subjectEdit()->text().length();
}
QList<NmMessagePart*> attachmentList;
mMessage->attachmentList(attachmentList);
okToExit = (toTextLength == 0 && ccTextLength == 0 && bccTextLength == 0 &&
subjectLength == 0 && mContentWidget->editor()->document()->isEmpty() &&
attachmentList.count() < 1);
// content exists, verify exit from user
if (!okToExit) {
if (mQueryDialog) {
delete mQueryDialog;
mQueryDialog = 0;
}
// Launch query dialog.
mQueryDialog = NmUtilities::displayQuestionNote(hbTrId("txt_mail_dialog_delete_message"),
this,
SLOT(okToExitQuery(HbAction*)));
}
}
// no need to query anything, just exit.
if(okToExit) {
QMetaObject::invokeMethod(&mApplication,
"popView",
Qt::QueuedConnection);
}
}
/*!
Handle the user selection is it ok to exit.
*/
void NmEditorView::okToExitQuery(HbAction* action)
{
// Check that 'Yes' button was pressed. Use loc string 'txt_mail_dialog_yes' when possible.
if (action->text() == "Yes") {
QMetaObject::invokeMethod(&mApplication,
"popView",
Qt::QueuedConnection);
}
}
/*!
About to exit view. Application calls this function when user has
pressed back key and editor needs to delete the draft message. This is
called when "auto-exiting" after a successful mail sending.
*/
void NmEditorView::aboutToExitView()
{
if (mStartParam && mStartParam->service() && mUiEngine.isSendingMessage()) {
// The application was started as a service and is about to close.
// A message is still being sent and in order to make sure that the
// send operation is not cancelled, let us display a modal wait dialog.
// When the send operation is completed, the dialog is automatically
// closed.
connect(&mUiEngine, SIGNAL(sendOperationCompleted()),
this, SLOT(handleSendOperationCompleted()));
// Close and delete the previous wait dialog if one exists.
if (mWaitDialog) {
mWaitDialog->close();
delete mWaitDialog;
}
// Construct and setup the wait dialog.
mWaitDialog = new HbProgressDialog();
mWaitDialog->setText(hbTrId("txt_mail_shareui_sending_please_wait"));
if (!XQServiceUtil::isEmbedded()) {
// Hide the application.
XQServiceUtil::toBackground(true);
}
// Display the wait dialog.
mWaitDialog->setModal(false);
mWaitDialog->setBackgroundFaded(false);
mWaitDialog->show();
delete mWaitDialog;
mWaitDialog = NULL;
}
// These operations need to be stopped before message can be deleted
if (mAddAttachmentOperation && mAddAttachmentOperation->isRunning()) {
mAddAttachmentOperation->cancelOperation();
}
if (mRemoveAttachmentOperation && mRemoveAttachmentOperation->isRunning()) {
mRemoveAttachmentOperation->cancelOperation();
}
if (mMessage) { // this is NULL if sending is started
// Delete message from drafts
NmId mailboxId = mMessage->envelope().mailboxId();
NmId folderId = mMessage->envelope().folderId();
NmId msgId = mMessage->envelope().messageId();
mUiEngine.removeMessage(mailboxId, folderId, msgId);
}
}
/*!
Lazy loading when view layout has been loaded
*/
void NmEditorView::viewReady()
{
// Connect signals from background scroll area
connect(mScrollArea, SIGNAL(handleMousePressEvent(QGraphicsSceneMouseEvent*)),
this, SLOT(sendMousePressEventToScroll(QGraphicsSceneMouseEvent*)));
connect(mScrollArea, SIGNAL(handleMouseReleaseEvent(QGraphicsSceneMouseEvent*)),
this, SLOT(sendMouseReleaseEventToScroll(QGraphicsSceneMouseEvent*)));
connect(mScrollArea, SIGNAL(handleMouseMoveEvent(QGraphicsSceneMouseEvent*)),
this, SLOT(sendMouseMoveEventToScroll(QGraphicsSceneMouseEvent*)));
connect(mScrollArea, SIGNAL(handleLongPressGesture(const QPointF &)),
this, SLOT(sendLongPressGesture(const QPointF &)));
// Connect options menu about to show to create options menu function
// Menu needs to be create "just-in-time"
connect(menu(), SIGNAL(aboutToShow()), this, SLOT(createOptionsMenu()));
NmAction *dummy = new NmAction(0);
menu()->addAction(dummy);
initializeVKB();
connect(mContentWidget->header(), SIGNAL(recipientFieldsHaveContent(bool)),
this, SLOT(setButtonsDimming(bool)) );
// call the createToolBar on load view layout
createToolBar();
// Set dimensions
adjustViewDimensions();
// Connect to observe orientation change events
connect(mApplication.mainWindow(), SIGNAL(orientationChanged(Qt::Orientation)),
this, SLOT(orientationChanged(Qt::Orientation)));
// Signal for handling the attachment list selection
connect(mHeaderWidget, SIGNAL(attachmentLongPressed(NmId, QPointF)),
this, SLOT(attachmentLongPressed(NmId, QPointF)));
// Set message data
setMessageData();
}
/*!
Find message data based on start parameters. Method is called
when editor is started. If message data is found it means that
operation is forward or reply message.
*/
void NmEditorView::setMessageData()
{
// Check the outbox.
if (mCheckOutboxOperation && mCheckOutboxOperation->isRunning()) {
mCheckOutboxOperation->cancelOperation();
NMLOG("NmEditorView::setMessageData old mCheckOutboxOperation running");
}
mCheckOutboxOperation = mUiEngine.checkOutbox(mStartParam->mailboxId());
if (mCheckOutboxOperation) {
connect(mCheckOutboxOperation, SIGNAL(operationCompleted(int)),
this, SLOT(outboxChecked(int)));
}
else {
startMessageCreation( mStartParam->editorStartMode() );
}
}
/*!
*/
void NmEditorView::startMessageCreation(NmUiEditorStartMode startMode)
{
NMLOG("NmEditorView::startMessageCreation ");
NmId mailboxId = mStartParam->mailboxId();
NmId folderId = mStartParam->folderId();
NmId msgId = mStartParam->messageId();
if (mMessageCreationOperation && mMessageCreationOperation->isRunning()) {
mMessageCreationOperation->cancelOperation();
}
// original message is now fetched so start message creation
if (startMode == NmUiEditorForward) {
mMessageCreationOperation = mUiEngine.createForwardMessage(mailboxId, msgId);
}
else if (startMode == NmUiEditorReply || startMode == NmUiEditorReplyAll) {
mMessageCreationOperation = mUiEngine.createReplyMessage(mailboxId,
msgId,
startMode == NmUiEditorReplyAll);
}
else {
mMessageCreationOperation = mUiEngine.createNewMessage(mailboxId);
}
// operation continues in messageCreated() once it finishes ok
if (mMessageCreationOperation) {
connect(mMessageCreationOperation,
SIGNAL(operationCompleted(int)),
this,
SLOT(messageCreated(int)));
}
}
/*!
Starting the message sending is handled here.
*/
void NmEditorView::startSending()
{
// The message contents should be verified
updateMessageWithEditorContents();
// verify addresses before sending
QList<NmAddress> invalidAddresses;
if (mMessage) {
NmUtilities::getRecipientsFromMessage(*mMessage, invalidAddresses, NmUtilities::InvalidAddress);
}
if (invalidAddresses.count() > 0) {
// invalid addresses found, verify send from user
QString noteText = hbTrId("txt_mail_dialog_invalid_mail_address_send");
// set the first failing address to the note
noteText = noteText.arg(invalidAddresses.at(0).address());
if (mQueryDialog) {
delete mQueryDialog;
mQueryDialog = 0;
}
// Launch query dialog. Pressing "yes" will finalize the sending.
mQueryDialog = NmUtilities::displayQuestionNote(noteText,
this,
SLOT(invalidAddressQuery(HbAction*)));
}
else {
// no need to ask anything, just send
finalizeSending();
}
}
/*!
Send the message after all checks have been done.
*/
void NmEditorView::finalizeSending()
{
QList<NmOperation *> preliminaryOperations;
preliminaryOperations.append(mAddAttachmentOperation);
preliminaryOperations.append(mRemoveAttachmentOperation);
// ownership of mMessage is transferred
// NmOperations are automatically deleted after completion
mUiEngine.sendMessage(mMessage, preliminaryOperations);
mMessage = NULL;
preliminaryOperations.clear();
// Must use delayed editor view destruction so that query dialog
// (which has signaled this) gets time to complete.
QMetaObject::invokeMethod(&mApplication,
"popView",
Qt::QueuedConnection);
}
/*!
Handle the user selection for invalid address query which was started by startSending.
*/
void NmEditorView::invalidAddressQuery(HbAction* action)
{
// Check that 'Yes' button was pressed. Use loc string 'txt_mail_dialog_yes' when possible.
if (action->text() == "Yes") {
finalizeSending();
}
}
/*!
This is signalled by mMessageCreationOperation when message is created.
*/
void NmEditorView::messageCreated(int result)
{
delete mMessage;
mMessage = NULL;
if (result == NmNoError && mMessageCreationOperation) {
NmUiEditorStartMode startMode = mStartParam->editorStartMode();
// get message "again" from engine to update the message contents
mMessage = mUiEngine.message(
mStartParam->mailboxId(),
mStartParam->folderId(),
mMessageCreationOperation->getMessageId());
fillEditorWithMessageContents();
}
}
/*!
Updates the message with the editor contents.
*/
void NmEditorView::updateMessageWithEditorContents()
{
if (mMessage) {
if (mContentWidget && mContentWidget->editor()) {
NmMessagePart* bodyPart = mMessage->htmlBodyPart();
if (bodyPart) {
bodyPart->setTextContent(mContentWidget->editor()->toHtml(), NmContentTypeTextHtml);
}
bodyPart = mMessage->plainTextBodyPart();
if (bodyPart) {
bodyPart->setTextContent(mContentWidget->editor()->toPlainText(), NmContentTypeTextPlain);
}
}
if (mContentWidget && mContentWidget->header() ) {
if (mContentWidget->header()->subjectEdit()) {
mMessage->envelope().setSubject(
mContentWidget->header()->subjectEdit()->text());
}
if (mContentWidget->header()->toEdit()) {
QString toFieldText =
mContentWidget->header()->toEdit()->text();
// This verification of zero length string isn't needed
// after list of addresses
if (toFieldText.length() > 0) {
mMessage->envelope().setToRecipients(mContentWidget->header()->toEdit()->emailAddressList());
}
}
if (mContentWidget->header()->ccEdit()) {
QString ccFieldText =
mContentWidget->header()->ccEdit()->text();
if (ccFieldText.length() > 0) {
mMessage->envelope().setCcRecipients(mContentWidget->header()->ccEdit()->emailAddressList());
}
}
if (mContentWidget->header()->bccEdit()) {
QString bccFieldText =
mContentWidget->header()->bccEdit()->text();
if (bccFieldText.length() > 0) {
mMessage->envelope().setBccRecipients(mContentWidget->header()->bccEdit()->emailAddressList());
}
}
}
}
}
/*!
Updates the message with the editor contents. Called only once when the
editor is launched.
*/
void NmEditorView::fillEditorWithMessageContents()
{
if (!mMessage || !mContentWidget) {
return;
}
NmMessageEnvelope messageEnvelope(mMessage->envelope());
NmUiEditorStartMode editorStartMode = NmUiEditorCreateNew;
bool useStartParam(false);
if (mStartParam) {
editorStartMode = mStartParam->editorStartMode();
if (editorStartMode == NmUiEditorMailto) {
// Retrieve the message header data e.g. recipients from mStartParam.
useStartParam = true;
}
}
// Set recipients (to, cc and bcc).
QString toAddressesString;
QString ccAddressesString;
QString bccAddressesString;
if (useStartParam) {
toAddressesString = addressListToString(mStartParam->mailtoAddressList());
ccAddressesString = addressListToString(mStartParam->ccAddressList());
bccAddressesString = addressListToString(mStartParam->bccAddressList());
}
else {
toAddressesString = addressListToString(messageEnvelope.toRecipients());
ccAddressesString = addressListToString(messageEnvelope.ccRecipients());
bccAddressesString = addressListToString(messageEnvelope.bccRecipients());
}
mContentWidget->header()->toEdit()->setPlainText(toAddressesString);
mContentWidget->header()->ccEdit()->setPlainText(ccAddressesString);
mContentWidget->header()->bccEdit()->setPlainText(bccAddressesString);
if (ccAddressesString.length() || bccAddressesString.length()) {
// Since cc or/and bcc recipients exist, expand the group box to display
// the addresses by expanding the group box.
mContentWidget->header()->setFieldVisibility(true);
}
// Set subject.
if (useStartParam) {
QString *subject = mStartParam->subject();
if (subject) {
mContentWidget->header()->subjectEdit()->setPlainText(*subject);
}
}
else {
// If a message is taken from the outbox, no subject formatting is done.
NmId notUsed(0);
if (mCheckOutboxOperation &&
mCheckOutboxOperation->getMessageId(notUsed)) {
editorStartMode = NmUiEditorCreateNew;
}
// Construct the subject field.
mContentWidget->header()->subjectEdit()->setPlainText(
addSubjectPrefix(editorStartMode, messageEnvelope.subject()));
}
// Set priority.
mHeaderWidget->setPriority(messageEnvelope.priority());
// Set the message body.
// Fetch plain text part form message store.
NmMessagePart *plainPart = mMessage->plainTextBodyPart();
if (plainPart) {
mUiEngine.contentToMessagePart(mMessage->envelope().mailboxId(),
mMessage->envelope().folderId(),
mMessage->envelope().messageId(),
*plainPart);
}
// Fetch html part form message store.
NmMessagePart *htmlPart = mMessage->htmlBodyPart();
if (htmlPart) {
mUiEngine.contentToMessagePart(mMessage->envelope().mailboxId(),
mMessage->envelope().folderId(),
mMessage->envelope().messageId(),
*htmlPart);
}
// Fetch attachment.html part form message store if such exists.
QList<NmMessagePart*> parts;
mMessage->attachmentList(parts);
NmMessagePart *attachmentHtml = NULL;
foreach(NmMessagePart *part, parts) {
if (part->contentDescription().startsWith(NmContentDescrAttachmentHtml)) {
attachmentHtml = part;
}
}
if (attachmentHtml) {
mUiEngine.contentToMessagePart(mMessage->envelope().mailboxId(),
mMessage->envelope().folderId(),
mMessage->envelope().messageId(),
*attachmentHtml);
}
// Set content data
if (editorStartMode==NmUiEditorReply||
editorStartMode==NmUiEditorReplyAll||
editorStartMode==NmUiEditorForward){
// Pass envelope ptr only when needed for reaply header creation
NmMessage *originalMessage = mUiEngine.message(mStartParam->mailboxId(),
mStartParam->folderId(),
mStartParam->messageId());
mContentWidget->setMessageData(*mMessage, &originalMessage->envelope());
delete originalMessage;
}
else{
// Reply header not needed, do not pass envelope ptr
mContentWidget->setMessageData(*mMessage);
}
// Get list of attachments from the message and set those into UI attachment list
QList<NmMessagePart*> attachments;
mMessage->attachmentList(attachments);
for (int i=0; i<attachments.count(); i++) {
mHeaderWidget->addAttachment(
attachments[i]->attachmentName(),
QString::number(attachments[i]->size()),
attachments[i]->partId());
}
if (mStartParam) {
// Attach passed files to the message.
QStringList *fileList = mStartParam->attachmentList();
if (fileList) {
addAttachments(*fileList);
}
}
// TODO Switch the following arbitrary (magic number) timeout to a
// meaningful constant, please!
QTimer::singleShot(200, mHeaderWidget, SLOT(sendHeaderHeightChanged()));
}
/*!
createToolBar. Function asks menu commands from extension
to be added to toolbar owned by the HbView.
*/
void NmEditorView::createToolBar()
{
HbToolBar *tb = toolBar();
NmUiExtensionManager &extMngr = mApplication.extManager();
if (tb && &extMngr && mStartParam) {
tb->clearActions();
NmActionRequest request(this, NmActionToolbar, NmActionContextViewEditor,
NmActionContextDataNone, mStartParam->mailboxId(), mStartParam->folderId() );
QList<NmAction *> list;
extMngr.getActions(request, list);
for (int i = 0; i < list.count(); i++) {
tb->addAction(list[i]);
// If action has NmSendable condition, it is shown only when send action
// is available, i.e. when at least one recipient field has data.
if( list[i]->availabilityCondition() == NmAction::NmSendable ) {
list[i]->setEnabled(false);
}
else if (list[i]->availabilityCondition() == NmAction::NmAttachable) {
HbToolBarExtension* extension = new HbToolBarExtension();
mAttachmentPicker = new NmAttachmentPicker(this);
if (extension && mAttachmentPicker) {
connect(mAttachmentPicker, SIGNAL(attachmentsFetchOk(const QVariant &)),
this, SLOT(onAttachmentReqCompleted(const QVariant &)));
HbAction* actionPhoto =
extension->addAction(hbTrId("txt_mail_list_photo"), extension, SLOT(close()));
connect(actionPhoto, SIGNAL(triggered()), mAttachmentPicker, SLOT(fetchImage()));
HbAction* actionMusic =
extension->addAction(hbTrId("txt_mail_list_music"), extension, SLOT(close()));
connect(actionMusic, SIGNAL(triggered()), mAttachmentPicker, SLOT(fetchAudio()));
HbAction* actionVideo =
extension->addAction(hbTrId("txt_mail_list_video"), extension, SLOT(close()));
HbAction* actionOther =
extension->addAction(hbTrId("txt_mail_list_other"), extension, SLOT(close()));
list[i]->setToolBarExtension(extension);
}
}
}
}
}
/*!
createOptionsMenu. Functions asks menu commands from extension
to be added to options menu.
*/
void NmEditorView::createOptionsMenu()
{
menu()->clearActions();
// Create CC/BCC options menu object
if (mCcBccFieldVisible) {
menu()->addAction(hbTrId("txt_mail_opt_hide_cc_bcc"), this, SLOT(switchCcBccFieldVisibility()));
}
else {
menu()->addAction(hbTrId("txt_mail_opt_show_cc_bcc"), this, SLOT(switchCcBccFieldVisibility()));
}
// Create Priority options menu object
if (!mPrioritySubMenu) {
mPrioritySubMenu = new HbMenu();
}
mPrioritySubMenu->clearActions();
NmActionRequest request(this, NmActionOptionsMenu, NmActionContextViewEditor,
NmActionContextDataMessage, mStartParam->mailboxId(), mStartParam->folderId(),
mStartParam->messageId());
NmUiExtensionManager &extMngr = mApplication.extManager();
QList<NmAction*> list;
extMngr.getActions(request, list);
for (int i = 0; i < list.count(); i++) {
mPrioritySubMenu->addAction(list[i]);
}
mPrioritySubMenu->setObjectName("editorPrioritySubMenu");
mPrioritySubMenu->setTitle(hbTrId("txt_mail_opt_add_priority"));
menu()->addMenu(mPrioritySubMenu);
}
/*!
Show or hide Cc field
*/
void NmEditorView::switchCcBccFieldVisibility()
{
if (mCcBccFieldVisible) {
mCcBccFieldVisible = false;
}
else {
mCcBccFieldVisible = true;
}
mHeaderWidget->setFieldVisibility( mCcBccFieldVisible );
QTimer::singleShot(NmOrientationTimer, this, SLOT(sendHeaderHeightChanged()));
}
/*!
handleActionCommand. From NmActionObserver, extension manager calls this
call to handle menu command in the UI.
*/
void NmEditorView::handleActionCommand(NmActionResponse &actionResponse)
{
NmActionResponseCommand responseCommand = actionResponse.responseCommand();
// Handle options menu
if (actionResponse.menuType() == NmActionOptionsMenu) {
setPriority(responseCommand);
}
else if (actionResponse.menuType() == NmActionToolbar) {
switch (responseCommand) {
case NmActionResponseCommandSendMail: {
// Just in case send mail would be somehow accessible during message creation or
// outobox checking
if ((!mCheckOutboxOperation || !mCheckOutboxOperation->isRunning())
&& (!mMessageCreationOperation || !mMessageCreationOperation->isRunning())) {
startSending();
}
break;
}
default:
break;
}
}
else if (actionResponse.menuType() == NmActionContextMenu) {
switch (responseCommand) {
case NmActionResponseCommandRemoveAttachment: {
removeAttachmentTriggered();
break;
}
case NmActionResponseCommandOpenAttachment: {
openAttachmentTriggered();
break;
}
default:
break;
}
}
}
/*!
This function converts background scroll area coordinate point into
body text editor coordinate point.
*/
QPointF NmEditorView::viewCoordinateToEditCoordinate(QPointF orgPoint)
{
QPointF contentWidgetPos = mScrollAreaContents->pos();
qreal y = orgPoint.y() - mHeaderWidget->headerHeight();
y -= contentWidgetPos.y();
qreal x = orgPoint.x() - contentWidgetPos.x();
return QPointF(x, y);
}
/*!
Send mouse press event to body edit widget
*/
void NmEditorView::sendMousePressEventToScroll(QGraphicsSceneMouseEvent *event)
{
if (event && mEditWidget && mHeaderWidget) {
event->setPos(viewCoordinateToEditCoordinate(event->pos()));
event->setAccepted(true);
mEditWidget->sendMousePressEvent(event);
}
}
/*!
Send mouse release event to body edit widget
*/
void NmEditorView::sendMouseReleaseEventToScroll(QGraphicsSceneMouseEvent *event)
{
if (event&& mEditWidget && mHeaderWidget) {
event->setPos(viewCoordinateToEditCoordinate(event->pos()));
event->setAccepted(true);
mEditWidget->sendMouseReleaseEvent(event);
}
}
/*!
Send mouse move event to body edit widget
*/
void NmEditorView::sendMouseMoveEventToScroll(QGraphicsSceneMouseEvent *event)
{
if (event&& mEditWidget && mHeaderWidget) {
event->setPos(viewCoordinateToEditCoordinate(event->pos()));
event->setAccepted(true);
mEditWidget->sendMouseMoveEvent(event);
}
}
void NmEditorView::sendLongPressGesture(const QPointF &point)
{
if (mEditWidget && mHeaderWidget) {
QPointF scenePos = mEditWidget->scenePos();
QPointF newPoint = QPointF(point.x()-scenePos.x(), point.y()-scenePos.y());
if(mEditWidget->contains(newPoint)) {
mEditWidget->sendLongPressEvent(point);
}
}
}
/*!
Sets all toolbar and VKB buttons dimmed state. All actions that have the
availability condition NmSendable set, will be enabled/disabled.
*/
void NmEditorView::setButtonsDimming(bool enabled)
{
// Set the toolbar action states
HbToolBar *tb = toolBar();
if (tb) {
QList<QAction *> toolbarList = tb->actions();
int count = toolbarList.count();
for (int i = 0; i < count; i++) {
NmAction *action = static_cast<NmAction *>(toolbarList[i]);
if (action->availabilityCondition() == NmAction::NmSendable) {
action->setEnabled(enabled);
}
}
// Set the VKB action states
// All editors of the view share the same action, so it is enough to set
// this only to one of them.
HbEditorInterface editorInterface(mContentWidget->editor());
QList<HbAction *> vkbList = editorInterface.actions();
count = vkbList.count();
for (int i = 0; i < count; i++) {
NmAction *action = static_cast<NmAction *>(vkbList[i]);
if (action->availabilityCondition() == NmAction::NmSendable) {
action->setEnabled(enabled);
}
}
}
}
/*!
Initialize the Virtual Keyboard to show the "Send" button
for all editors of the view.
*/
void NmEditorView::initializeVKB()
{
NmActionRequest request(this, NmActionVKB, NmActionContextViewEditor,
NmActionContextDataNone, mStartParam->mailboxId(), mStartParam->folderId() );
NmUiExtensionManager &extMngr = mApplication.extManager();
if (&extMngr) {
QList<NmAction *> list;
extMngr.getActions(request, list);
// VKB only supports one application key, but the responsibility of giving only one
// action is left to the extension plugin. The rest are still attached to the VKB, but
// they are not shown (unless VKB starts supporting more than one).
for (int i = 0; i < list.count(); i++) {
if( list[i]->availabilityCondition() == NmAction::NmSendable ) {
list[i]->setEnabled(false);
}
list[i]->setIcon(NmIcons::getIcon(NmIcons::NmIconSend));
// Link VKB to the action. This must be done to all
// editors that show the button in VKB.
HbEditorInterface editorInterface(mContentWidget->editor());
editorInterface.addAction(list[i]);
HbEditorInterface toEditorInterface(mContentWidget->header()->toEdit());
toEditorInterface.addAction(list[i]);
HbEditorInterface ccEditorInterface(mContentWidget->header()->ccEdit());
ccEditorInterface.addAction(list[i]);
HbEditorInterface bccEditorInterface(mContentWidget->header()->bccEdit());
bccEditorInterface.addAction(list[i]);
HbEditorInterface subjectEditorInterface(mContentWidget->header()->subjectEdit());
subjectEditorInterface.addAction(list[i]);
}
}
}
/*!
Set mailbox name to title
*/
void NmEditorView::setMailboxName()
{
if (mStartParam){
NmMailboxMetaData *meta = mUiEngine.mailboxById(mStartParam->mailboxId());
if (meta){
setTitle(meta->name());
}
}
}
/*!
Adds a prefix to the subject for reply or forward.
Strips other occurrences of the prefix from the beginning.
*/
QString NmEditorView::addSubjectPrefix( NmUiEditorStartMode startMode, const QString &subject )
{
QString newSubject(subject.trimmed());
if (startMode == NmUiEditorReply || startMode == NmUiEditorReplyAll ||
startMode == NmUiEditorForward) {
QString rePrefix(hbTrId("txt_nmailui_reply_subject_prefix"));
QString fwPrefix(hbTrId("txt_nmailui_forward_subject_prefix"));
// strip extra prefixes from beginning
int rePrefixLength(rePrefix.length());
int fwPrefixLength(fwPrefix.length());
bool startswithRe(newSubject.startsWith(rePrefix, Qt::CaseInsensitive));
bool startswithFw(newSubject.startsWith(fwPrefix, Qt::CaseInsensitive));
while (startswithRe || startswithFw) {
if (startswithRe) {
newSubject.remove(0,rePrefixLength);
newSubject = newSubject.trimmed();
}
else if (startswithFw) {
newSubject.remove(0,fwPrefixLength);
newSubject = newSubject.trimmed();
}
startswithRe = newSubject.startsWith(rePrefix, Qt::CaseInsensitive);
startswithFw = newSubject.startsWith(fwPrefix, Qt::CaseInsensitive);
}
if (startMode == NmUiEditorReply || startMode == NmUiEditorReplyAll) {
newSubject = rePrefix + " " + newSubject;
}
else if (startMode == NmUiEditorForward) {
newSubject = fwPrefix + " " + newSubject;
}
}
return newSubject;
}
/*!
This slot is called when 'attachment picker' request has been performed succesfully
Parameter 'value' contains file currently one file name but later list of the files.
*/
void NmEditorView::onAttachmentReqCompleted(const QVariant &value)
{
//temporary fix for music picker back button:
//it shouldn't emit requestOk signal when nothing is selected
if (value.canConvert<QStringList>()) {
QStringList list = value.toStringList();
if (!list.at(0).isEmpty()) {
addAttachments(list);
}
}
}
/*!
Closes the wait dialog if one exists.
This slot is called if the mail application has been started as a service
and is about to close. Closing the application while still sending a message
may cause unwanted cancelling of the operation.
*/
void NmEditorView::handleSendOperationCompleted()
{
if (mWaitDialog) {
mWaitDialog->close();
}
}
/*!
Add list of attachments
*/
void NmEditorView::addAttachments(const QStringList& fileNames)
{
NMLOG("NmEditorView::addAttachments");
// Add attachment name into UI
foreach (QString fileName, fileNames) {
// At this phase attachment size and nmid are not known
mHeaderWidget->addAttachment(fileName, QString("0"), NmId(0));
NMLOG(fileName);
}
// Cancel previous operation if it's not running.
if (mAddAttachmentOperation) {
if (!mAddAttachmentOperation->isRunning()) {
mAddAttachmentOperation->cancelOperation();
}
}
// Start operation to attach file or list of files into mail message.
// This will also copy files into message store.
mAddAttachmentOperation = mUiEngine.addAttachments(*mMessage, fileNames);
if (mAddAttachmentOperation) {
enableToolBarAttach(false);
// Signal to inform completion of one attachment
connect(mAddAttachmentOperation,
SIGNAL(operationPartCompleted(const QString &, const NmId &, int)),
this,
SLOT(oneAttachmentAdded(const QString &, const NmId &, int)));
// Signal to inform the completion of the whole operation
connect(mAddAttachmentOperation,
SIGNAL(operationCompleted(int)),
this,
SLOT(allAttachmentsAdded(int)));
}
}
/*!
This slot is called to create context menu when attachment has been selected
from UI by longpress.
*/
void NmEditorView::attachmentLongPressed(NmId attachmentPartId, QPointF point)
{
// Store id of the attachment to be removed into member.
// It is used by removeAttachmentTriggered later if 'remove' selected.
mSelectedAttachment = attachmentPartId;
if (!mAttachmentListContextMenu) {
mAttachmentListContextMenu = new HbMenu();
}
mAttachmentListContextMenu->clearActions();
NmActionRequest request(this, NmActionContextMenu, NmActionContextViewEditor,
NmActionContextDataMessage, mStartParam->mailboxId(), mStartParam->folderId(),
mStartParam->messageId());
NmUiExtensionManager &extensionManager = mApplication.extManager();
if (&extensionManager) {
QList<NmAction*> actionList;
extensionManager.getActions(request, actionList);
for (int i = 0; i < actionList.count(); ++i) {
mAttachmentListContextMenu->addAction(actionList[i]);
}
}
// Add menu position check here, so that it does not go outside of the screen
QPointF menuPos(point.x(),point.y());
mAttachmentListContextMenu->setPreferredPos(menuPos);
mAttachmentListContextMenu->open();
}
/*!
This is signalled by mAddAttachmentOperation when the operation is
completed for one attachment.
*/
void NmEditorView::oneAttachmentAdded(const QString &fileName, const NmId &msgPartId, int result)
{
if (result == NmNoError && mMessage) {
// Need to get the message again because new attachment part has been added.
NmId mailboxId = mMessage->envelope().mailboxId();
NmId folderId = mMessage->envelope().folderId();
NmId msgId = mMessage->envelope().messageId();
delete mMessage;
mMessage = NULL;
mMessage = mUiEngine.message(mailboxId, folderId, msgId);
if (mMessage) {
// Get attachment list from the message
QList<NmMessagePart*> attachmentList;
mMessage->attachmentList(attachmentList);
// Search newly added attachment from the list
for (int i=0; i<attachmentList.count(); i++) {
if (attachmentList[i]->partId() == msgPartId) {
// Get attachment file size and set it into UI
mHeaderWidget->setAttachmentParameters(fileName,
msgPartId,
QString().setNum(attachmentList[i]->size()),
result);
}
}
}
}
else {
// Attachment adding failed. Show an error note and remove from UI attachment list.
NMLOG(QString("nmailui: attachment adding into message failed: %1").arg(fileName));
mHeaderWidget->removeAttachment(fileName);
}
}
/*!
This is signalled by mAddAttachmentOperation when the operation is
completed totally.
*/
void NmEditorView::allAttachmentsAdded(int result)
{
enableToolBarAttach(true);
if (result != NmNoError) {
NmUtilities::displayWarningNote(hbTrId("txt_mail_dialog_unable_to_add_attachment"));
}
}
/*!
This is signalled by mCheckOutboxOperation when the operation is complete.
*/
void NmEditorView::outboxChecked(int result)
{
bool messageInOutbox = false;
if (result == NmNoError && mCheckOutboxOperation) {
NmId messageId;
messageInOutbox = mCheckOutboxOperation->getMessageId(messageId);
if (messageInOutbox) {
delete mMessage;
mMessage = NULL;
mMessage = mUiEngine.message(
mStartParam->mailboxId(),
mUiEngine.standardFolderId(
mStartParam->mailboxId(), NmFolderOutbox),
messageId);
fillEditorWithMessageContents();
if (mMessage) {
NmUtilities::displayWarningNote(
hbTrId("txt_mail_dialog_sending failed").arg(
NmUtilities::truncate(
mMessage->envelope().subject(), 20)));
}
}
}
if (!messageInOutbox) {
startMessageCreation(mStartParam->editorStartMode());
}
}
/*!
Sets priority for the message object that is being edited
*/
void NmEditorView::setPriority(NmActionResponseCommand priority)
{
mHeaderWidget->setPriority(priority);
if (mMessage) {
NmMessagePriority messagePriority = NmMessagePriorityNormal;
if (priority == NmActionResponseCommandPriorityHigh) {
messagePriority = NmMessagePriorityHigh;
}
else if (priority == NmActionResponseCommandPriorityLow) {
messagePriority = NmMessagePriorityLow;
}
mMessage->envelope().setPriority(messagePriority);
}
}
/*!
Extracts the addresses from the given list into a string separated with a
delimiter.
\param list The list containing the addresses.
\return String containing the addresses.
*/
QString NmEditorView::addressListToString(const QList<NmAddress*> &list) const
{
QString addressesString;
QList<NmAddress*>::const_iterator i = list.constBegin();
while (i != list.constEnd() && *i) {
if (i > list.constBegin()) {
// Add the delimiter.
addressesString += Delimiter;
}
addressesString += (*i)->address();
++i;
}
return addressesString;
}
/*!
Extracts the addresses from the given list into a string separated with a
delimiter.
\param list The list containing the addresses.
\return String containing the addresses.
*/
QString NmEditorView::addressListToString(const QList<NmAddress> &list) const
{
QString addressesString;
QList<NmAddress>::const_iterator i = list.constBegin();
while (i != list.constEnd()) {
if (i > list.constBegin()) {
// Add the delimiter.
addressesString += Delimiter;
}
addressesString += (*i).address();
++i;
}
return addressesString;
}
/*!
This slot is called when 'remove' is selected from attachment list context menu.
*/
void NmEditorView::removeAttachmentTriggered()
{
// Cancel will delete previous operation
if (mRemoveAttachmentOperation) {
if (!mRemoveAttachmentOperation->isRunning()) {
mRemoveAttachmentOperation->cancelOperation();
}
}
// Remove from UI
mHeaderWidget->removeAttachment(mSelectedAttachment);
// Remove from message store
mRemoveAttachmentOperation = mUiEngine.removeAttachment(*mMessage, mSelectedAttachment);
if (mRemoveAttachmentOperation) {
// Signal to inform the remove operation completion
connect(mRemoveAttachmentOperation,
SIGNAL(operationCompleted(int)),
this,
SLOT(attachmentRemoved(int)));
}
}
/*!
This slot is called by mRemoveAttachmentOperation when the operation is
completed. There is no need to update UI because it was already updated.
*/
void NmEditorView::attachmentRemoved(int result)
{
// It is not desided yet what to do if operation fails
Q_UNUSED(result);
if (mMessage) {
// Reload message because one attachment has been removed
NmId mailboxId = mMessage->envelope().mailboxId();
NmId folderId = mMessage->envelope().folderId();
NmId msgId = mMessage->envelope().messageId();
delete mMessage;
mMessage = NULL;
mMessage = mUiEngine.message(mailboxId, folderId, msgId);
}
}
/*!
This slot is called when 'open' is selected from attachment list context menu.
*/
void NmEditorView::openAttachmentTriggered()
{
mHeaderWidget->launchAttachment(mSelectedAttachment);
}
/*!
Enables/disables toolbar extension for attach
*/
void NmEditorView::enableToolBarAttach(bool enable)
{
HbToolBar *tb = toolBar();
if (tb) {
QList<QAction *> toolbarList = tb->actions();
int count = toolbarList.count();
for (int i = 0; i < count; i++) {
NmAction *action = static_cast<NmAction *>(toolbarList[i]);
if (action->availabilityCondition() == NmAction::NmAttachable) {
action->setEnabled(enable);
}
}
}
}
// End of file.