kopete/kopete/kopetewindow.h

   1 /*
   2     kopetewindow.h  -  Kopete Main Window
   3
   4     Copyright (c) 2001-2002 by Duncan Mac-Vicar Prett <duncan@kde.org>
   5     Copyright (c) 2001-2002 by Stefan Gehn            <metz AT gehn.net>
   6     Copyright (c) 2002-2003 by Martijn Klingens       <klingens@kde.org>
   7
   8     Kopete    (c) 2002-2008 by the Kopete developers  <kopete-devel@kde.org>
   9
  10     *************************************************************************
  11     *                                                                       *
  12     * This program is free software; you can redistribute it and/or modify  *
  13     * it under the terms of the GNU General Public License as published by  *
  14     * the Free Software Foundation; either version 2 of the License, or     *
  15     * (at your option) any later version.                                   *
  16     *                                                                       *
  17     *************************************************************************
  18 */
  19
  20 #ifndef KOPETEWINDOW_H
  21 #define KOPETEWINDOW_H
  22
  23 // Qt includes
  24 #include <QtGui/QLabel>
  25
  26 // KDE includes
  27 #include <kxmlguiwindow.h>
  28
  29 class QCloseEvent;
  30 class QEvent;
  31 class QShowEvent;
  32
  33 class KMenu;
  34
  35 namespace Kopete
  36 {
  37         class Identity;
  38         class Account;
  39         class Contact;
  40         class Plugin;
  41         class StatusMessage;
  42         class StatusRootAction;
  43 }
  44
  45 /**
  46  * @author Duncan Mac-Vicar P. <duncan@kde.org>
  47  */
  48 class KopeteWindow : public KXmlGuiWindow
  49 {
  50         Q_OBJECT
  51
  52 public:
  53         explicit KopeteWindow ( QWidget *parent = 0 );
  54         ~KopeteWindow();
  55
  56         virtual bool eventFilter( QObject* o, QEvent* e );
  57
  58 protected:
  59         virtual void closeEvent( QCloseEvent *ev );
  60         virtual void leaveEvent( QEvent* ev );
  61         virtual void showEvent( QShowEvent* ev );
  62         virtual void hideEvent( QHideEvent* ev );
  63
  64 private slots:
  65         void slotToggleShowAllOfflineEmpty( bool toggled );
  66         void slotToggleShowOfflineUsers();
  67         void slotToggleShowEmptyGroups();
  68         void slotConfigChanged();
  69         void slotConfNotifications();
  70         void slotConfToolbar();
  71         void slotUpdateToolbar();
  72         void slotConfGlobalKeys();
  73         void slotShowHide();
  74         void slotToggleAway();
  75
  76
  77         void setStatusMessage( const Kopete::StatusMessage& );
  78
  79         void globalStatusChanged();
  80
  81         /**
  82          * Checks if the mousecursor is in the contact list.
  83          * If not, the window will be hidden.
  84          */
  85         void slotAutoHide();
  86
  87         /**
  88          * Resize window to fit size of contact list nicely.
  89          */
  90         void slotUpdateSize();
  91
  92         void slotStartAutoResizeTimer();
  93
  94         /**
  95          * This slot will apply settings that change the
  96          * contact list's appearance. Only autohiding is
  97          * handled here at the moment
  98          */
  99         void slotContactListAppearanceChanged();
 100
 101         /**
 102          * This slot will set all the protocols to away
 103          */
 104         void slotGlobalAway();
 105         void slotGlobalBusy();
 106         void slotGlobalAvailable();
 107         void slotSetInvisibleAll();
 108         void slotDisconnectAll();
 109
 110         void slotQuit();
 111
 112         /**
 113          * Get a notification when a plugin is loaded, so we can merge
 114          * XMLGUI cruft
 115          */
 116         void slotPluginLoaded( Kopete::Plugin *p );
 117
 118         /**
 119          * Get a notification when an identity is created, so we can add a status bar
 120          * icon
 121          * @param identity the registered identity
 122          */
 123         void slotIdentityRegistered( Kopete::Identity *identity );
 124
 125         /**
 126          * Cleanup the status bar icon when the identity is destroyed
 127          * @param identity the unregistered identity
 128          */
 129         void slotIdentityUnregistered( const Kopete::Identity *identity );
 130
 131         /**
 132          * The tooltip got changed, update it.
 133          * @param identity the identity that has changed
 134          */
 135         void slotIdentityToolTipChanged( Kopete::Identity *identity );
 136
 137         /**
 138          * The status icon got changed, update it.
 139          * @param identity the identity that has changed
 140          */
 141         void slotIdentityStatusIconChanged( Kopete::Identity *identity );
 142
 143         /**
 144          * Show a in-place widget for an identity
 145          */
 146         void slotIdentityStatusIconLeftClicked( Kopete::Identity *i,
 147                 const QPoint &p );
 148
 149
 150         /**
 151          * This is used to add the account to the "Add Contact" submenu
 152          */
 153         void slotAccountRegistered( Kopete::Account *account );
 154
 155         /**
 156          * This is used to add the account to the "Add Contact" submenu
 157          */
 158         void slotAccountUnregistered( const Kopete::Account *account );
 159
 160         void slotTrayAboutToShowMenu(KMenu *);
 161
 162         /**
 163          * Show the Add Contact wizard
 164          */
 165         void showAddContactDialog( Kopete::Account * );
 166
 167         /**
 168          * Show the Export Contacts wizards
 169          */
 170         void showExportDialog();
 171
 172         /**
 173          * Enable the Connect All and Disconnect All buttons here
 174          * along with connecting the accountRegistered and accountUnregistered
 175          * signals.
 176          */
 177         void slotAllPluginsLoaded();
 178
 179         /**
 180          * Show the set global status message menu when clicking on the icon in the status bar.
 181          */
 182         void slotGlobalStatusMessageIconClicked( const QPoint &position );
 183
 184         /**
 185          * Show Info Event widget and if necessary raise the Kopete window.
 186          */
 187         void slotShowInfoEventWidget();
 188
 189         /**
 190          * Show/hide Info Event widget.
 191          */
 192         void slotInfoIconClicked();
 193
 194         /**
 195          * Extracts protocolId and accountId from the single QString argument signalled by a QSignalMapper,
 196          * get the account, and call showAddContactDialog.
 197          * @param accountIdentifer QString of protocolId and accountId, concatenated with QChar( 0xE000 )
 198          * We need both to uniquely identify an account, but QSignalMapper only emits one QString.
 199          */
 200         void slotAddContactDialogInternal( const QString & accountIdentifier );
 201
 202         void updateStatusMenuMessage( Kopete::StatusRootAction *statusRootAction );
 203
 204 private:
 205         void initView();
 206         void initActions();
 207         void initSystray();
 208         void loadOptions();
 209         void saveOptions();
 210
 211         void makeTrayToolTip();
 212         void startAutoHideTimer();
 213
 214         virtual bool queryClose();
 215         virtual bool queryExit();
 216
 217 private:
 218         class Private;
 219         Private * const d;
 220 };
 221
 222
 223 class GlobalStatusMessageIconLabel : public QLabel
 224 {
 225       Q_OBJECT
 226 public:
 227       GlobalStatusMessageIconLabel(QWidget *parent = 0);
 228
 229 protected:
 230       void mouseReleaseEvent(QMouseEvent *event);
 231
 232 signals:
 233       void iconClicked(const QPoint &position);
 234
 235 };
 236
 237 class InfoEventIconLabel : public QLabel
 238 {
 239         Q_OBJECT
 240 public:
 241         InfoEventIconLabel( QWidget *parent = 0 );
 242
 243 protected:
 244         void mouseReleaseEvent( QMouseEvent *event );
 245
 246 signals:
 247         void clicked();
 248
 249 private slots:
 250         void updateIcon();
 251
 252 };
 253
 254 #endif
 255 // vim: set noet ts=4 sts=4 sw=4: