summaryrefslogtreecommitdiffstats
path: root/kmail/recipientseditor.h
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commit460c52653ab0dcca6f19a4f492ed2c5e4e963ab0 (patch)
tree67208f7c145782a7e90b123b982ca78d88cc2c87 /kmail/recipientseditor.h
downloadtdepim-460c52653ab0dcca6f19a4f492ed2c5e4e963ab0.tar.gz
tdepim-460c52653ab0dcca6f19a4f492ed2c5e4e963ab0.zip
Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.
BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdepim@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'kmail/recipientseditor.h')
-rw-r--r--kmail/recipientseditor.h366
1 files changed, 366 insertions, 0 deletions
diff --git a/kmail/recipientseditor.h b/kmail/recipientseditor.h
new file mode 100644
index 000000000..91adee7d0
--- /dev/null
+++ b/kmail/recipientseditor.h
@@ -0,0 +1,366 @@
+/*
+ This file is part of KMail.
+
+ Copyright (c) 2004 Cornelius Schumacher <[email protected]>
+
+ This program is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 2 of the License, or
+ (at your option) any later version.
+
+ This program 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 General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+
+ As a special exception, permission is given to link this program
+ with any edition of Qt, and distribute the resulting executable,
+ without including the source code for Qt in the source distribution.
+*/
+#ifndef RECIPIENTSEDITOR_H
+#define RECIPIENTSEDITOR_H
+
+#include <qwidget.h>
+#include <qscrollview.h>
+#include <qguardedptr.h>
+#include <qlineedit.h>
+#include <qtooltip.h>
+
+#include "kmlineeditspell.h"
+#include <qcombobox.h>
+
+class RecipientsPicker;
+
+class KWindowPositioner;
+
+class QLabel;
+class QPushButton;
+class SideWidget;
+
+class Recipient
+{
+ public:
+ typedef QValueList<Recipient> List;
+
+ enum Type { To, Cc, Bcc, Undefined };
+
+ Recipient( const QString &email = QString::null, Type type = To );
+
+ void setType( Type );
+ Type type() const;
+
+ void setEmail( const QString & );
+ QString email() const;
+
+ bool isEmpty() const;
+
+ static int typeToId( Type );
+ static Type idToType( int );
+
+ QString typeLabel() const; static QString typeLabel( Type );
+ static QStringList allTypeLabels();
+
+ private:
+ QString mEmail;
+ Type mType;
+};
+
+class RecipientComboBox : public QComboBox
+{
+ Q_OBJECT
+ public:
+ RecipientComboBox( QWidget *parent );
+
+ signals:
+ void rightPressed();
+
+ protected:
+ void keyPressEvent( QKeyEvent *ev );
+};
+
+class RecipientLineEdit : public KMLineEdit
+{
+ Q_OBJECT
+ public:
+ RecipientLineEdit( QWidget * parent ) :
+ KMLineEdit( true, parent ) {}
+
+ signals:
+ void deleteMe();
+ void leftPressed();
+ void rightPressed();
+
+ protected:
+ void keyPressEvent( QKeyEvent *ev );
+};
+
+class RecipientLine : public QWidget
+{
+ Q_OBJECT
+ public:
+ RecipientLine( QWidget *parent );
+
+ void setRecipient( const Recipient & );
+ Recipient recipient() const;
+
+ void setRecipientType( Recipient::Type );
+ Recipient::Type recipientType() const;
+
+ void setRecipient( const QString & );
+
+ void activate();
+ bool isActive();
+
+ bool isEmpty();
+
+ /** Returns true if the user has made any modifications to this
+ RecipientLine.
+ */
+ bool isModified();
+
+ /** Resets the modified flag to false.
+ */
+ void clearModified();
+
+ int setComboWidth( int w );
+
+ void fixTabOrder( QWidget *previous );
+ QWidget *tabOut() const;
+
+ void clear();
+
+ int recipientsCount();
+
+ void setRemoveLineButtonEnabled( bool b );
+
+ signals:
+ void returnPressed( RecipientLine * );
+ void downPressed( RecipientLine * );
+ void upPressed( RecipientLine * );
+ void rightPressed();
+ void deleteLine( RecipientLine * );
+ void countChanged();
+ void typeModified( RecipientLine * );
+
+ protected:
+ void keyPressEvent( QKeyEvent * );
+ RecipientLineEdit* lineEdit() const { return mEdit; }
+
+ protected slots:
+ void slotReturnPressed();
+ void analyzeLine( const QString & );
+ void slotFocusUp();
+ void slotFocusDown();
+ void slotPropagateDeletion();
+ void slotTypeModified();
+
+ private:
+ friend class RecipientsView;
+ QComboBox *mCombo;
+ RecipientLineEdit *mEdit;
+ QPushButton *mRemoveButton;
+ int mRecipientsCount;
+ bool mModified;
+};
+
+class RecipientsView : public QScrollView
+{
+ Q_OBJECT
+ public:
+ RecipientsView( QWidget *parent );
+
+ QSize minimumSizeHint() const;
+ QSize sizeHint() const;
+
+ RecipientLine *activeLine();
+
+ RecipientLine *emptyLine();
+
+ Recipient::List recipients() const;
+
+ /** Removes the recipient provided it can be found and has the given type.
+ @param recipient The recipient(s) you want to remove.
+ @param type The recipient type.
+ */
+ void removeRecipient( const QString & recipient, Recipient::Type type );
+
+ /** Returns true if the user has made any modifications to the list of
+ recipients.
+ */
+ bool isModified();
+
+ /** Resets the modified flag to false.
+ */
+ void clearModified();
+
+ void activateLine( RecipientLine * );
+
+ /**
+ * Set the width of the left most column to be the argument width.
+ * This method allows other widgets to align their label/combobox column with ours
+ * by communicating how many pixels that first colum is for them.
+ * Returns the width that is actually being used.
+ */
+ int setFirstColumnWidth( int );
+
+ public slots:
+ void setCompletionMode( KGlobalSettings::Completion );
+ RecipientLine *addLine();
+
+ void setFocus();
+ void setFocusTop();
+ void setFocusBottom();
+
+ signals:
+ void totalChanged( int recipients, int lines );
+ void focusUp();
+ void focusDown();
+ void focusRight();
+ void completionModeChanged( KGlobalSettings::Completion );
+ void sizeHintChanged();
+
+ protected:
+ void viewportResizeEvent( QResizeEvent * );
+ void resizeView();
+
+ protected slots:
+ void slotReturnPressed( RecipientLine * );
+ void slotDownPressed( RecipientLine * );
+ void slotUpPressed( RecipientLine * );
+ void slotDecideLineDeletion( RecipientLine * );
+ void slotDeleteLine();
+ void calculateTotal();
+ void slotTypeModified( RecipientLine * );
+ void moveCompletionPopup();
+
+ private:
+ QPtrList<RecipientLine> mLines;
+ QGuardedPtr<RecipientLine> mCurDelLine;
+ int mLineHeight;
+ int mFirstColumnWidth;
+ bool mModified;
+ KGlobalSettings::Completion mCompletionMode;
+};
+
+class RecipientsToolTip : public QToolTip
+{
+ public:
+ RecipientsToolTip( RecipientsView *, QWidget *parent );
+
+ protected:
+ void maybeTip( const QPoint & p );
+
+ QString line( const Recipient & );
+
+ private:
+ RecipientsView *mView;
+};
+
+class SideWidget : public QWidget
+{
+ Q_OBJECT
+ public:
+ SideWidget( RecipientsView *view, QWidget *parent );
+ ~SideWidget();
+
+ RecipientsPicker* picker() const;
+
+ public slots:
+ void setTotal( int recipients, int lines );
+ void setFocus();
+
+ void pickRecipient();
+
+ signals:
+ void pickedRecipient( const Recipient & );
+ void saveDistributionList();
+
+ private:
+ RecipientsView *mView;
+ QLabel *mTotalLabel;
+ QPushButton *mDistributionListButton;
+ QPushButton *mSelectButton;
+ /** The RecipientsPicker is lazy loaded, never access it directly,
+ only through picker() */
+ mutable RecipientsPicker *mRecipientPicker;
+ /** lazy loaded, don't access directly, unless you've called picker() */
+ mutable KWindowPositioner *mPickerPositioner;
+};
+
+class RecipientsEditor : public QWidget
+{
+ Q_OBJECT
+ public:
+ RecipientsEditor( QWidget *parent );
+ ~RecipientsEditor();
+
+ void clear();
+
+ Recipient::List recipients() const;
+ RecipientsPicker* picker() const;
+
+ void setRecipientString( const QString &, Recipient::Type );
+ QString recipientString( Recipient::Type );
+
+ /** Adds a recipient (or multiple recipients) to one line of the editor.
+ @param recipient The recipient(s) you want to add.
+ @param type The recipient type.
+ */
+ void addRecipient( const QString & recipient, Recipient::Type type );
+
+ /** Removes the recipient provided it can be found and has the given type.
+ @param recipient The recipient(s) you want to remove.
+ @param type The recipient type.
+ */
+ void removeRecipient( const QString & recipient, Recipient::Type type );
+
+ /** Returns true if the user has made any modifications to the list of
+ recipients.
+ */
+ bool isModified();
+
+ /** Resets the modified flag to false.
+ */
+ void clearModified();
+
+ /**
+ * Set the width of the left most column to be the argument width.
+ * This method allows other widgets to align their label/combobox column with ours
+ * by communicating how many pixels that first colum is for them.
+ * Returns the width that is actually being used.
+ */
+ int setFirstColumnWidth( int );
+
+ /**
+ * Set completion mode for all lines
+ */
+ void setCompletionMode( KGlobalSettings::Completion );
+
+ public slots:
+ void setFocus();
+ void setFocusTop();
+ void setFocusBottom();
+
+ void selectRecipients();
+ void saveDistributionList();
+
+ signals:
+ void focusUp();
+ void focusDown();
+ void completionModeChanged( KGlobalSettings::Completion );
+ void sizeHintChanged();
+
+ protected slots:
+ void slotPickedRecipient( const Recipient & );
+
+ private:
+ RecipientsView *mRecipientsView;
+ SideWidget* mSideWidget;
+ bool mModified;
+};
+
+#endif