summaryrefslogtreecommitdiffstats
path: root/kopete/libkopete/ui/contactaddednotifydialog.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
commitbcb704366cb5e333a626c18c308c7e0448a8e69f (patch)
treef0d6ab7d78ecdd9207cf46536376b44b91a1ca71 /kopete/libkopete/ui/contactaddednotifydialog.h
downloadtdenetwork-bcb704366cb5e333a626c18c308c7e0448a8e69f.tar.gz
tdenetwork-bcb704366cb5e333a626c18c308c7e0448a8e69f.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/kdenetwork@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'kopete/libkopete/ui/contactaddednotifydialog.h')
-rw-r--r--kopete/libkopete/ui/contactaddednotifydialog.h175
1 files changed, 175 insertions, 0 deletions
diff --git a/kopete/libkopete/ui/contactaddednotifydialog.h b/kopete/libkopete/ui/contactaddednotifydialog.h
new file mode 100644
index 00000000..96f8844c
--- /dev/null
+++ b/kopete/libkopete/ui/contactaddednotifydialog.h
@@ -0,0 +1,175 @@
+/*
+ Copyright (c) 2005 Olivier Goffart <ogoffart@ kde.org>
+
+ Kopete (c) 2005 by the Kopete developers <kopete-devel@kde.org>
+
+ *************************************************************************
+ * *
+ * This library is free software; you can redistribute it and/or *
+ * modify it under the terms of the GNU Lesser General Public *
+ * License as published by the Free Software Foundation; either *
+ * version 2 of the License, or (at your option) any later version. *
+ * *
+ *************************************************************************
+*/
+
+
+#ifndef KOPETE_UICONTACTADDEDNOTIFYDIALOG_H
+#define KOPETE_UICONTACTADDEDNOTIFYDIALOG_H
+
+#include <kdialogbase.h>
+#include "kopete_export.h"
+
+namespace KABC {
+ class Addressee;
+}
+
+namespace Kopete {
+
+class Group;
+class Account;
+class MetaContact;
+
+namespace UI {
+
+/**
+ * @brief Dialog which is shown when a contact added you in the contactlist.
+ *
+ * This dialog asks the user to give authorization for the addition to the
+ * person who added the user and also asks the user if the contact who you've
+ * received the notification for should be added to the user's contact list
+ *
+ * example of usage
+ * @code
+
+ Kopete::UI::ContactAddedNotifyDialog *dialog =
+ new ContactAddedNotifyDialog(contactId, QString::null,account);
+ QObject::connect(dialog,SIGNAL(applyClicked(const QString&)),this,SLOT(contactAddedDialogApplied()));
+ QObject::connect(dialog,SIGNAL(infoClicked(const QString&)),this,SLOT(contactAddedDialogInfo()));
+ dialog->show();
+
+ * @endcode
+ *
+ * and in your contactAddedDialogApplied slot
+ * @code
+ const Kopete::UI::ContactAddedNotifyDialog *dialog =
+ dynamic_cast<const Kopete::UI::ContactAddedNotifyDialog *>(sender());
+ if(!dialog)
+ return;
+ if(dialog->authorized())
+ socket->authorize(contactId);
+ if(dialog->added())
+ dialog->addContact();
+ * @endcode
+ *
+ * Note that you can also use exec() but this is not recommended
+ *
+ * @author Olivier Goffart
+ * @since 0.11
+ */
+class KOPETE_EXPORT ContactAddedNotifyDialog : public KDialogBase
+{
+Q_OBJECT
+public:
+ /**
+ * All widget in the dialog that may be hidden.
+ */
+ enum HideWidget
+ {
+ InfoButton = 0x01, /**< the button which ask for more info about the contact */
+ AuthorizeCheckBox = 0x02, /**< the checkbox which ask for authorize the contact */
+ AddCheckBox = 0x04, /**< the checkbox which ask if the contact should be added */
+ AddGroupBox = 0x08 /**< all the widget about metacontact properties */
+ };
+
+ /**
+ * @brief Constructor
+ *
+ * The dialog is by default not modal, and will delete itself when closed
+ *
+ * @param contactId the contactId of the contact which just added the user
+ * @param contactNick the nickname of the contact if available.
+ * @param account is used to display the account icon and informaiton about the account
+ * @param hide a bitmask of HideWidget used to hide some widget. By default, everything is shown.
+ *
+ */
+ ContactAddedNotifyDialog(const QString& contactId, const QString& contactNick=QString::null,
+ Kopete::Account *account=0L, uint hide=0x00);
+
+ /**
+ * @brief Destructor
+ */
+ ~ContactAddedNotifyDialog();
+
+ /**
+ * @brief return if the user has checked the "authorize" checkbox
+ * @return true if the authorize checkbox is checked, false otherwise
+ */
+ bool authorized() const;
+
+ /**
+ * @brief return if the user has checked the "add" checkbox
+ * @return true if the add checkbox is checked, false otherwise
+ */
+ bool added() const;
+
+ /**
+ * @brief return the display name the user has entered
+ */
+ QString displayName() const;
+
+ /**
+ * @brief return the group the user has selected
+ *
+ * If the user has entered a group which doesn't exist yet, it will be created now
+ */
+ Group* group() const;
+
+public slots:
+
+ /**
+ * @brief create a metacontact.
+ *
+ * This function only works if the add checkbox is checked, otherwise,
+ * it will return 0L.
+ *
+ * it uses the Account::addContact function to add the contact
+ *
+ * @return the new metacontact created, or 0L if the operation failed.
+ */
+ MetaContact *addContact() const;
+
+signals:
+ /**
+ * @brief the dialog has been applied
+ * @param contactId is the id of the contact passed in the constructor.
+ */
+ void applyClicked(const QString &contactId);
+
+ /**
+ * @brief the button "info" has been pressed
+ * If you haven't hidden the more info button, you should connect this
+ * signal to a slot which show a dialog with more info about the
+ * contact.
+ *
+ * hint: you can use sender() as parent of the new dialog
+ * @param contactId is the id of the contact passed in the constructor.
+ */
+ void infoClicked(const QString &contactId);
+
+
+private slots:
+ void slotAddresseeSelected( const KABC::Addressee &);
+ void slotInfoClicked();
+ void slotFinished();
+
+private:
+ struct Private;
+ Private *d;
+};
+
+
+
+} // namespace UI
+} // namespace Kopete
+#endif