workspace/kwin/placement.h

   1 /********************************************************************
   2  KWin - the KDE window manager
   3  This file is part of the KDE project.
   4
   5 Copyright (C) 1999, 2000 Matthias Ettrich <ettrich@kde.org>
   6 Copyright (C) 1997 to 2002 Cristian Tibirna <tibirna@kde.org>
   7 Copyright (C) 2003 Lubos Lunak <l.lunak@kde.org>
   8
   9 This program is free software; you can redistribute it and/or modify
  10 it under the terms of the GNU General Public License as published by
  11 the Free Software Foundation; either version 2 of the License, or
  12 (at your option) any later version.
  13
  14 This program is distributed in the hope that it will be useful,
  15 but WITHOUT ANY WARRANTY; without even the implied warranty of
  16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17 GNU General Public License for more details.
  18
  19 You should have received a copy of the GNU General Public License
  20 along with this program.  If not, see <http://www.gnu.org/licenses/>.
  21 *********************************************************************/
  22
  23 #ifndef KWIN_PLACEMENT_H
  24 #define KWIN_PLACEMENT_H
  25
  26 #include <QPoint>
  27 #include <QRect>
  28 #include <QList>
  29
  30 namespace KWin
  31 {
  32
  33 class Workspace;
  34 class Client;
  35
  36 class Placement
  37     {
  38     public:
  39
  40         Placement(Workspace* w);
  41
  42         /**
  43          * Placement policies. How workspace decides the way windows get positioned
  44          * on the screen. The better the policy, the heavier the resource use.
  45          * Normally you don't have to worry. What the WM adds to the startup time
  46          * is nil compared to the creation of the window itself in the memory
  47          */
  48         enum Policy
  49             {
  50             NoPlacement, // not really a placement
  51             Default, // special, means to use the global default
  52             Unknown, // special, means the function should use its default
  53             Random,
  54             Smart,
  55             Cascade,
  56             Centered,
  57             ZeroCornered,
  58             UnderMouse, // special
  59             OnMainWindow, // special
  60             Maximizing
  61             };
  62
  63         void place(Client* c, QRect& area );
  64
  65         void placeAtRandom            (Client* c, const QRect& area, Policy next = Unknown );
  66         void placeCascaded            (Client* c, QRect& area, Policy next = Unknown );
  67         void placeSmart               (Client* c, const QRect& area, Policy next = Unknown );
  68         void placeMaximizing          (Client* c, QRect& area, Policy next = Unknown );
  69         void placeCentered    (Client* c, const QRect& area, Policy next = Unknown );
  70         void placeZeroCornered(Client* c, const QRect& area, Policy next = Unknown );
  71         void placeDialog      (Client* c, QRect& area, Policy next = Unknown );
  72         void placeUtility     (Client* c, QRect& area, Policy next = Unknown );
  73
  74         void reinitCascading( int desktop );
  75
  76         static Policy policyFromString( const QString& policy, bool no_special );
  77         static const char* policyToString( Policy policy );
  78
  79     private:
  80
  81         void place(Client* c, QRect& area, Policy policy, Policy nextPlacement = Unknown );
  82         void placeUnderMouse(Client* c, QRect& area, Policy next = Unknown );
  83         void placeOnMainWindow(Client* c, QRect& area, Policy next = Unknown );
  84         QRect checkArea( const Client*c, const QRect& area );
  85
  86         Placement();
  87
  88     //CT needed for cascading+
  89         struct DesktopCascadingInfo
  90             {
  91             QPoint pos;
  92             int col;
  93             int row;
  94             };
  95
  96         QList<DesktopCascadingInfo> cci;
  97
  98         Workspace* m_WorkspacePtr;
  99     };
 100
 101 } // namespace
 102
 103 #endif