kwin/src/placement.h
Vlad Zahorodnii 7096e3ead8 Run clang-format
The .clang-format file is based on the one in ECM except the following
style options:

 - AlwaysBreakBeforeMultilineStrings
 - BinPackArguments
 - BinPackParameters
 - ColumnLimit
 - BreakBeforeBraces
 - KeepEmptyLinesAtTheStartOfBlocks
2022-03-25 13:25:15 +02:00

100 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 <QList>
#include <QPoint>
#include <QRect>
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