addresseelineedit.h

Go to the documentation of this file.

/*
  This file is part of libkdepim.

  Copyright (c) 2002 Helge Deller <deller@gmx.de>
  Copyright (c) 2002 Lubos Lunak <llunak@suse.cz>
  Copyright (c) 2001,2003 Carsten Pfeiffer <pfeiffer@kde.org>
  Copyright (c) 2001 Waldo Bastian <bastian@kde.org>
  Copyright (c) 2004 Daniel Molkentin <danimo@klaralvdalens-datakonsult.se>
  Copyright (c) 2004 Karl-Heinz Zimmer <khz@klaralvdalens-datakonsult.se>

  This library is free software; you can redistribute it and/or
  modify it under the terms of the GNU Library General Public
  License as published by the Free Software Foundation; either
  version 2 of the License, or (at your option) any later version.

  This library is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  Library General Public License for more details.

  You should have received a copy of the GNU Library General Public License
  along with this library; see the file COPYING.LIB.  If not, write to
  the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  Boston, MA 02110-1301, USA.
*/

#ifndef KDEPIM_ADDRESSEELINEEDIT_H
#define KDEPIM_ADDRESSEELINEEDIT_H

#include "kdepim_export.h"

#include "ldap/ldapclient.h"

#include <KLineEdit>

class QDropEvent;
class QEvent;
class QKeyEvent;
class QMenu;
class QMouseEvent;
class QObject;

namespace Akonadi {
class Item;
}

namespace KABC {
class Addressee;
class ContactGroup;
}

namespace KPIM {

class AddresseeLineEditPrivate;
class KDEPIM_EXPORT AddresseeLineEdit : public KLineEdit
{
    Q_OBJECT

public:
    explicit AddresseeLineEdit( QWidget *parent, bool enableCompletion = true );

    virtual ~AddresseeLineEdit();

    void allowSemicolonAsSeparator( bool allow );

    void setFont( const QFont &font );

    void setEnableBalooSearch(bool enable);

    bool isCompletionEnabled() const;
Q_SIGNALS:
    void textCompleted();

public Q_SLOTS:
    void cursorAtEnd();

    void enableCompletion( bool enable );

    virtual void setText( const QString &text );

public:
    void addContact( const KABC::Addressee &contact, int weight, int source = -1, QString append = QString() );

    void addContactGroup( const KABC::ContactGroup &group, int weight, int source = -1 );

    void addItem( const Akonadi::Item &item, int weight, int source = -1 );

    int addCompletionSource( const QString &name, int weight );

    void removeCompletionSource(const QString &source);
    void emitTextCompleted();

    void callUserCancelled( const QString &str );
    void callSetCompletedText(const QString& /*text*/, bool /*marked*/);
    void callSetCompletedText(const QString& text);
    void callSetUserSelection(bool);
protected:
    virtual void insert( const QString & );

    virtual void paste();

    virtual void mouseReleaseEvent( QMouseEvent * );

#ifndef QT_NO_DRAGANDDROP

    virtual void dropEvent( QDropEvent * );
#endif

    virtual void keyPressEvent( QKeyEvent * );

#ifndef QT_NO_CONTEXTMENU

    virtual QMenu *createStandardContextMenu();

    virtual void contextMenuEvent( QContextMenuEvent * );
#endif

    QStringList cleanupEmailList(const QStringList &inputList);
    virtual void configureCompletionOrder(QMenu *menu);
private:
    virtual bool eventFilter( QObject *, QEvent * );

    AddresseeLineEditPrivate* const d;
};

}

#endif