/*
 * 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:
    /**
     * Gesture event, overridden from base class.
     */
    void gestureEvent(QGestureEvent* 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.
     * @param pos tap position.
     */
    void shortTapAction(QString anchor,const QPointF& pos); 
    
    /** 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);
    
    /**
     * Helper method to populate menu items.
     * @param contextMenu menu to be populated.
     * @param data, highlighted number.
     */
    void populateMenu(HbMenu* contextMenu, const QString& data);
    
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 context sensitive menu items.
     */
    void openContactInfo();
    void call();
    void sendMessage();
    void createEmail();
    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;

#ifdef MSGUI_UNIT_TEST
    /**
     * Unit Testing
     */
    friend class TestUniViewerAddressWidget;
#endif

    };

#endif // UNI_VIEWER_ADDRESS_WIDGET_H
// EOF