kwin/src/placement.h
Vlad Zahorodnii 93e0265e4e Move source code to src/ directory
Once in a while, we receive complaints from other fellow KDE developers
about the file organization of kwin. This change addresses some of those
complaints by moving all of source code in a separate directory, src/,
thus making the project structure more traditional. Things such as tests
are kept in their own toplevel directories.

This change may wreak havoc on merge requests that add new files to kwin,
but if a patch modifies an already existing file, git should be smart
enough to figure out that the file has been relocated.

We may potentially split the src/ directory further to make navigating
the source code easier, but hopefully this is good enough already.
2021-02-10 15:31:43 +00:00

99 lines
2.9 KiB
C++

/*
KWin - the KDE window manager
This file is part of the KDE project.
SPDX-FileCopyrightText: 1999, 2000 Matthias Ettrich <ettrich@kde.org>
SPDX-FileCopyrightText: 1997-2002 Cristian Tibirna <tibirna@kde.org>
SPDX-FileCopyrightText: 2003 Lubos Lunak <l.lunak@kde.org>
SPDX-License-Identifier: GPL-2.0-or-later
*/
#ifndef KWIN_PLACEMENT_H
#define KWIN_PLACEMENT_H
// KWin
#include <kwinglobals.h>
// Qt
#include <QPoint>
#include <QRect>
#include <QList>
class QObject;
namespace KWin
{
class AbstractClient;
class KWIN_EXPORT Placement
{
public:
virtual ~Placement();
/**
* Placement policies. How workspace decides the way windows get positioned
* on the screen. The better the policy, the heavier the resource use.
* Normally you don't have to worry. What the WM adds to the startup time
* is nil compared to the creation of the window itself in the memory
*/
enum Policy {
NoPlacement, // not really a placement
Default, // special, means to use the global default
Unknown, // special, means the function should use its default
Random,
Smart,
Cascade,
Centered,
ZeroCornered,
UnderMouse, // special
OnMainWindow, // special
Maximizing
};
void place(AbstractClient *c, const QRect &area);
void placeSmart(AbstractClient* c, const QRect& area, Policy next = Unknown);
void placeCentered(AbstractClient* c, const QRect& area, Policy next = Unknown);
void reinitCascading(int desktop);
/**
* Cascades all clients on the current desktop
*/
void cascadeDesktop();
/**
* Unclutters the current desktop by smart-placing all clients again.
*/
void unclutterDesktop();
static const char* policyToString(Policy policy);
private:
void place(AbstractClient *c, const QRect &area, Policy policy, Policy nextPlacement = Unknown);
void placeUnderMouse(AbstractClient *c, const QRect &area, Policy next = Unknown);
void placeOnMainWindow(AbstractClient *c, const QRect &area, Policy next = Unknown);
void placeTransient(AbstractClient *c);
void placeAtRandom(AbstractClient* c, const QRect& area, Policy next = Unknown);
void placeCascaded(AbstractClient* c, const QRect& area, Policy next = Unknown);
void placeMaximizing(AbstractClient* c, const QRect& area, Policy next = Unknown);
void placeZeroCornered(AbstractClient* c, const QRect& area, Policy next = Unknown);
void placeDialog(AbstractClient* c, const QRect& area, Policy next = Unknown);
void placeUtility(AbstractClient* c, const QRect& area, Policy next = Unknown);
void placeOnScreenDisplay(AbstractClient* c, const QRect& area);
//CT needed for cascading+
struct DesktopCascadingInfo {
QPoint pos;
int col;
int row;
};
QList<DesktopCascadingInfo> cci;
KWIN_SINGLETON(Placement)
};
} // namespace
#endif