/*

 * 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