messagingapp/msgui/unifiedviewer/inc/univieweraddresswidget.h
changeset 31 ebfee66fde93
child 34 84197e66a4bd
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/messagingapp/msgui/unifiedviewer/inc/univieweraddresswidget.h	Fri Jun 04 10:25:39 2010 +0100
@@ -0,0 +1,151 @@
+/*
+ * Copyright (c) 2009 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: Custom widget derived from HbTextEdit which provides rich text
+ *              processing
+ *
+ */
+#ifndef UNI_VIEWER_ADDRESS_WIDGET_H
+#define UNI_VIEWER_ADDRESS_WIDGET_H
+
+#include <HbTextEdit>
+
+#include "unidatamodelplugininterface.h"
+
+/**
+ * UniViewerAddressWidget provides support for rich text processing
+ */
+class UniViewerAddressWidget : public HbTextEdit
+{
+    Q_OBJECT
+    
+public:
+    /**
+     * Constructor
+     */
+    UniViewerAddressWidget(QGraphicsItem * parent = 0);
+
+    /**
+     * Destructor
+     */
+    ~UniViewerAddressWidget();
+    
+    /**
+     * Populates the addresses and creates the anchors on them.
+     * @param label Label of the address like - "From"
+     * @param address Address string to be populated.
+     */
+    void populate(const QString &label, const QString &address, const QString &alias);
+
+    /**
+     * Populates the addresses and creates the anchors on them.
+     * @param label Label of the address like - "To", "Cc"
+     * @param addressList List of addresses to be populated.
+     */
+    void populate(const QString &label,ConvergedMessageAddressList addressList);
+
+    /**
+     * Clears the contents of the widget.
+     */
+    void clearContent();
+
+protected:
+
+    /**
+     * called when mouse is pressed.
+     */
+    void mousePressEvent(QGraphicsSceneMouseEvent *event);
+
+    /**
+     * called when mouse is released.
+     */
+    void mouseReleaseEvent(QGraphicsSceneMouseEvent *event);
+    
+private:
+    /**
+     * Helper method to highlight find item on tap.
+     * @param highlight, if true highlight else dont.
+     */
+    void highlightText(bool highlight);
+    
+    /**
+     * short tap handler.
+     * @param anchor anchor at cursor position.
+     */
+    void shortTapAction(QString anchor); 
+    
+    /** Helper method to get contact id against phone number or e-mail id.
+     * @param value phone number or email id.
+     * @param fieldName name of field to be matched.
+     * @param fieldType type of field to be matched.
+     */
+    int resolveContactId(const QString& value,
+                         const QString& fieldName, 
+                         const QString& fieldType);
+    
+    
+private slots:
+
+    /**
+      * called when aboutToShowContextMenu signal is emitted.
+      */
+    void aboutToShowContextMenu(HbMenu *contextMenu, const QPointF &pos);
+    
+    /**
+     * Called when option menu is closed.
+     */
+    void menuClosed();
+    
+    //handlers for phone number specific menu items.
+    void openContactInfo();
+    void call();
+    void saveToContacts();
+    void sendMessage();
+    void copyToClipboard();
+    
+    //called after service request is completed.
+    void onServiceRequestCompleted();
+    
+    /**
+     * Slot for handling valid returns from the framework.
+     * 
+     * @param result const QVariant&
+     */
+    void handleOk(const QVariant& result);
+    
+    /**
+     * Slot for handling errors. Error ids are provided as 
+     * 32-bit integers.
+     * @param errorCode qint32
+     */
+    void handleError(int errorCode, const QString& errorMessage);
+    
+
+signals:
+    /**
+     * this signal is emitted when send message is triggered for a highlighted number.
+     */
+    void sendMessage(const QString& phoneNumber,const QString& alias);
+    
+private:
+    //Current cursor position.
+    int mCursorPos;
+    
+    //char formats for highlight.
+    QTextCharFormat mFormatHighlight;
+    QTextCharFormat mFormatNormal;
+
+    };
+
+#endif // UNI_VIEWER_ADDRESS_WIDGET_H
+// EOF