libkdepim/overlaywidget.h

   1 /* -*- c++ -*-
   2  * overlaywidget.h
   3  *
   4  *  Copyright (c) 2004 David Faure <faure@kde.org>
   5  *
   6  *  This program is free software; you can redistribute it and/or modify
   7  *  it under the terms of the GNU General Public License as published by
   8  *  the Free Software Foundation; version 2 of the License
   9  *
  10  *  This program is distributed in the hope that it will be useful,
  11  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13  *  GNU General Public License for more details.
  14  *
  15  *  You should have received a copy of the GNU General Public License
  16  *  along with this program; if not, write to the Free Software
  17  *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  18  *
  19  *  In addition, as a special exception, the copyright holders give
  20  *  permission to link the code of this program with any edition of
  21  *  the Qt library by Trolltech AS, Norway (or with modified versions
  22  *  of Qt that use the same license as Qt), and distribute linked
  23  *  combinations including the two.  You must obey the GNU General
  24  *  Public License in all respects for all of the code used other than
  25  *  Qt.  If you modify this file, you may extend this exception to
  26  *  your version of the file, but you are not obligated to do so.  If
  27  *  you do not wish to do so, delete this exception statement from
  28  *  your version.
  29  */
  30 #ifndef KDEPIM_OVERLAYWIDGET_H
  31 #define KDEPIM_OVERLAYWIDGET_H
  32
  33 #include "kdepim_export.h"
  34
  35 #include <KHBox>
  36
  37 class QResizeEvent;
  38 class QEvent;
  39
  40 namespace KPIM {
  41
  42 /**
  43  * This is a widget that can align itself with another one, without using a layout,
  44  * so that it can actually be on top of other widgets.
  45  * Currently the only supported type of alignment is "right aligned, on top of the other widget".
  46  *
  47  * OverlayWidget inherits KHBox for convenience purposes (layout, and frame)
  48  */
  49 class KDEPIM_EXPORT OverlayWidget : public KHBox
  50 {
  51   Q_OBJECT
  52
  53 public:
  54   OverlayWidget( QWidget* alignWidget, QWidget* parent, const char* name = 0 );
  55   ~OverlayWidget();
  56
  57   QWidget * alignWidget() { return mAlignWidget; }
  58   void setAlignWidget( QWidget * alignWidget );
  59
  60 protected:
  61   void resizeEvent( QResizeEvent* ev );
  62   bool eventFilter( QObject* o, QEvent* e);
  63
  64 private:
  65   void reposition();
  66
  67 private:
  68   QWidget * mAlignWidget;
  69 };
  70
  71 } // namespace
  72
  73 #endif /* OVERLAYWIDGET_H */
  74