abstract_client.h 37.1 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23
/********************************************************************
 KWin - the KDE window manager
 This file is part of the KDE project.

Copyright (C) 2015 Martin Gräßlin <mgraesslin@kde.org>

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.
*********************************************************************/
#ifndef KWIN_ABSTRACT_CLIENT_H
#define KWIN_ABSTRACT_CLIENT_H

#include "toplevel.h"
24
#include "options.h"
25
#include "rules.h"
26
#include "tabgroup.h"
27

28 29
#include <memory>

30
#include <QElapsedTimer>
31
#include <QPointer>
32

33 34 35 36 37 38 39 40
namespace KWayland
{
namespace Server
{
class PlasmaWindowInterface;
}
}

41 42 43 44 45
namespace KDecoration2
{
class Decoration;
}

46 47 48 49 50 51 52 53
namespace KWin
{

namespace TabBox
{
class TabBoxClientImpl;
}

54 55
namespace Decoration
{
56
class DecoratedClientImpl;
57 58 59
class DecorationPalette;
}

60
class KWIN_EXPORT AbstractClient : public Toplevel
61 62
{
    Q_OBJECT
63 64 65 66 67 68 69 70 71 72 73
    /**
     * Whether this Client is fullScreen. A Client might either be fullScreen due to the _NET_WM property
     * or through a legacy support hack. The fullScreen state can only be changed if the Client does not
     * use the legacy hack. To be sure whether the state changed, connect to the notify signal.
     **/
    Q_PROPERTY(bool fullScreen READ isFullScreen WRITE setFullScreen NOTIFY fullScreenChanged)
    /**
     * Whether the Client can be set to fullScreen. The property is evaluated each time it is invoked.
     * Because of that there is no notify signal.
     **/
    Q_PROPERTY(bool fullScreenable READ isFullScreenable)
74 75 76 77 78
    /**
     * Whether this Client is the currently visible Client in its Client Group (Window Tabs).
     * For change connect to the visibleChanged signal on the Client's Group.
     **/
    Q_PROPERTY(bool isCurrentTab READ isCurrentTab)
79 80 81 82 83
    /**
     * Whether this Client is active or not. Use Workspace::activateClient() to activate a Client.
     * @see Workspace::activateClient
     **/
    Q_PROPERTY(bool active READ isActive NOTIFY activeChanged)
84 85 86 87 88 89 90 91
    /**
     * The desktop this Client is on. If the Client is on all desktops the property has value -1.
     **/
    Q_PROPERTY(int desktop READ desktop WRITE setDesktop NOTIFY desktopChanged)
    /**
     * Whether the Client is on all desktops. That is desktop is -1.
     **/
    Q_PROPERTY(bool onAllDesktops READ isOnAllDesktops WRITE setOnAllDesktops NOTIFY desktopChanged)
92 93 94 95
    /**
     * Indicates that the window should not be included on a taskbar.
     **/
    Q_PROPERTY(bool skipTaskbar READ skipTaskbar WRITE setSkipTaskbar NOTIFY skipTaskbarChanged)
96 97 98 99
    /**
     * Indicates that the window should not be included on a Pager.
     **/
    Q_PROPERTY(bool skipPager READ skipPager WRITE setSkipPager NOTIFY skipPagerChanged)
100 101 102 103
    /**
     * Whether the Client should be excluded from window switching effects.
     **/
    Q_PROPERTY(bool skipSwitcher READ skipSwitcher WRITE setSkipSwitcher NOTIFY skipSwitcherChanged)
104 105 106 107 108
    /**
     * Whether the window can be closed by the user. The value is evaluated each time the getter is called.
     * Because of that no changed signal is provided.
     **/
    Q_PROPERTY(bool closeable READ isCloseable)
109
    Q_PROPERTY(QIcon icon READ icon NOTIFY iconChanged)
110 111 112 113 114 115 116 117
    /**
     * Whether the Client is set to be kept above other windows.
     **/
    Q_PROPERTY(bool keepAbove READ keepAbove WRITE setKeepAbove NOTIFY keepAboveChanged)
    /**
     * Whether the Client is set to be kept below other windows.
     **/
    Q_PROPERTY(bool keepBelow READ keepBelow WRITE setKeepBelow NOTIFY keepBelowChanged)
118 119 120 121 122 123 124 125 126
    /**
     * Whether the Client can be shaded. The property is evaluated each time it is invoked.
     * Because of that there is no notify signal.
     **/
    Q_PROPERTY(bool shadeable READ isShadeable)
    /**
     * Whether the Client is shaded.
     **/
    Q_PROPERTY(bool shade READ isShade WRITE setShade NOTIFY shadeChanged)
127 128 129 130 131 132 133 134 135
    /**
     * Whether the Client can be minimized. The property is evaluated each time it is invoked.
     * Because of that there is no notify signal.
     **/
    Q_PROPERTY(bool minimizable READ isMinimizable)
    /**
     * Whether the Client is minimized.
     **/
    Q_PROPERTY(bool minimized READ isMinimized WRITE setMinimized NOTIFY minimizedChanged)
136 137 138 139 140 141 142
    /**
     * The optional geometry representing the minimized Client in e.g a taskbar.
     * See _NET_WM_ICON_GEOMETRY at http://standards.freedesktop.org/wm-spec/wm-spec-latest.html .
     * The value is evaluated each time the getter is called.
     * Because of that no changed signal is provided.
     **/
    Q_PROPERTY(QRect iconGeometry READ iconGeometry)
143 144 145 146 147 148 149 150
    /**
     * Returns whether the window is any of special windows types (desktop, dock, splash, ...),
     * i.e. window types that usually don't have a window frame and the user does not use window
     * management (moving, raising,...) on them.
     * The value is evaluated each time the getter is called.
     * Because of that no changed signal is provided.
     **/
    Q_PROPERTY(bool specialWindow READ isSpecialWindow)
151 152 153 154 155 156 157 158 159
    /**
     * Whether window state _NET_WM_STATE_DEMANDS_ATTENTION is set. This state indicates that some
     * action in or with the window happened. For example, it may be set by the Window Manager if
     * the window requested activation but the Window Manager refused it, or the application may set
     * it if it finished some work. This state may be set by both the Client and the Window Manager.
     * It should be unset by the Window Manager when it decides the window got the required attention
     * (usually, that it got activated).
     **/
    Q_PROPERTY(bool demandsAttention READ isDemandingAttention WRITE demandAttention NOTIFY demandsAttentionChanged)
160 161 162 163 164
    /**
     * The Caption of the Client. Read from WM_NAME property together with a suffix for hostname and shortcut.
     * To read only the caption as provided by WM_NAME, use the getter with an additional @c false value.
     **/
    Q_PROPERTY(QString caption READ caption NOTIFY captionChanged)
165 166 167 168 169 170 171 172
    /**
     * Minimum size as specified in WM_NORMAL_HINTS
     **/
    Q_PROPERTY(QSize minSize READ minSize)
    /**
     * Maximum size as specified in WM_NORMAL_HINTS
     **/
    Q_PROPERTY(QSize maxSize READ maxSize)
173 174 175 176 177 178
    /**
     * Whether the Client can accept keyboard focus.
     * The value is evaluated each time the getter is called.
     * Because of that no changed signal is provided.
     **/
    Q_PROPERTY(bool wantsInput READ wantsInput)
179 180 181 182 183
    /**
     * Whether the Client is a transient Window to another Window.
     * @see transientFor
     **/
    Q_PROPERTY(bool transient READ isTransient NOTIFY transientChanged)
184 185 186 187
    /**
     * The Client to which this Client is a transient if any.
     **/
    Q_PROPERTY(KWin::AbstractClient *transientFor READ transientFor NOTIFY transientChanged)
188 189 190 191
    /**
     * Whether the Client represents a modal window.
     **/
    Q_PROPERTY(bool modal READ isModal NOTIFY modalChanged)
192 193 194 195 196
    /**
     * The geometry of this Client. Be aware that depending on resize mode the geometryChanged signal
     * might be emitted at each resize step or only at the end of the resize operation.
     **/
    Q_PROPERTY(QRect geometry READ geometry WRITE setGeometry)
197 198 199 200 201 202 203 204 205 206
    /**
     * Whether the Client is currently being moved by the user.
     * Notify signal is emitted when the Client starts or ends move/resize mode.
     **/
    Q_PROPERTY(bool move READ isMove NOTIFY moveResizedChanged)
    /**
     * Whether the Client is currently being resized by the user.
     * Notify signal is emitted when the Client starts or ends move/resize mode.
     **/
    Q_PROPERTY(bool resize READ isResize NOTIFY moveResizedChanged)
207 208 209 210
    /**
     * Whether the decoration is currently using an alpha channel.
     **/
    Q_PROPERTY(bool decorationHasAlpha READ decorationHasAlpha)
211 212 213 214 215 216 217
    /**
     * Whether the window has a decoration or not.
     * This property is not allowed to be set by applications themselves.
     * The decision whether a window has a border or not belongs to the window manager.
     * If this property gets abused by application developers, it will be removed again.
     **/
    Q_PROPERTY(bool noBorder READ noBorder WRITE setNoBorder)
218 219 220 221 222
    /**
     * Whether the Client provides context help. Mostly needed by decorations to decide whether to
     * show the help button or not.
     **/
    Q_PROPERTY(bool providesContextHelp READ providesContextHelp CONSTANT)
223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246
    /**
     * Whether the Client can be maximized both horizontally and vertically.
     * The property is evaluated each time it is invoked.
     * Because of that there is no notify signal.
     **/
    Q_PROPERTY(bool maximizable READ isMaximizable)
    /**
     * Whether the Client is moveable. Even if it is not moveable, it might be possible to move
     * it to another screen. The property is evaluated each time it is invoked.
     * Because of that there is no notify signal.
     * @see moveableAcrossScreens
     **/
    Q_PROPERTY(bool moveable READ isMovable)
    /**
     * Whether the Client can be moved to another screen. The property is evaluated each time it is invoked.
     * Because of that there is no notify signal.
     * @see moveable
     **/
    Q_PROPERTY(bool moveableAcrossScreens READ isMovableAcrossScreens)
    /**
     * Whether the Client can be resized. The property is evaluated each time it is invoked.
     * Because of that there is no notify signal.
     **/
    Q_PROPERTY(bool resizeable READ isResizable)
247 248 249
public:
    virtual ~AbstractClient();

250 251 252
    QWeakPointer<TabBox::TabBoxClientImpl> tabBoxClient() const {
        return m_tabBoxClient.toWeakRef();
    }
253 254 255
    bool isFirstInTabBox() const {
        return m_firstInTabBox;
    }
256 257 258 259
    bool skipSwitcher() const {
        return m_skipSwitcher;
    }
    void setSkipSwitcher(bool set);
260

261 262 263 264 265 266 267 268 269
    bool skipTaskbar() const {
        return m_skipTaskbar;
    }
    void setSkipTaskbar(bool set);
    void setOriginalSkipTaskbar(bool set);
    bool originalSkipTaskbar() const {
        return m_originalSkipTaskbar;
    }

270 271 272 273 274
    bool skipPager() const {
        return m_skipPager;
    }
    void setSkipPager(bool set);

275 276 277 278
    const QIcon &icon() const {
        return m_icon;
    }

279 280 281 282 283 284 285 286 287 288 289 290 291 292 293
    bool isActive() const {
        return m_active;
    }
    /**
     * Sets the client's active state to \a act.
     *
     * This function does only change the visual appearance of the client,
     * it does not change the focus setting. Use
     * Workspace::activateClient() or Workspace::requestFocus() instead.
     *
     * If a client receives or looses the focus, it calls setActive() on
     * its own.
     **/
    void setActive(bool);

294 295 296 297 298 299 300 301 302
    bool keepAbove() const {
        return m_keepAbove;
    }
    void setKeepAbove(bool);
    bool keepBelow() const {
        return m_keepBelow;
    }
    void setKeepBelow(bool);

303 304 305 306 307
    void demandAttention(bool set = true);
    bool isDemandingAttention() const {
        return m_demandsAttention;
    }

308 309
    void cancelAutoRaise();

310 311
    bool wantsTabFocus() const;

312 313 314 315
    QPoint clientPos() const override {
        return QPoint(borderLeft(), borderTop());
    }

316 317 318 319 320
    virtual void updateMouseGrab();
    virtual QString caption(bool full = true, bool stripped = false) const = 0;
    virtual bool isCloseable() const = 0;
    // TODO: remove boolean trap
    virtual bool isShown(bool shaded_is_shown) const = 0;
321
    virtual bool isHiddenInternal() const = 0;
322 323
    // TODO: remove boolean trap
    virtual void hideClient(bool hide) = 0;
324
    virtual bool isFullScreenable() const = 0;
325
    virtual bool isFullScreen() const = 0;
326 327
    // TODO: remove boolean trap
    virtual AbstractClient *findModal(bool allow_itself = false) = 0;
328
    virtual bool isTransient() const;
329 330 331 332 333 334 335 336 337
    /**
     * @returns Whether there is a hint available to place the AbstractClient on it's parent, default @c false.
     * @see transientPlacementHint
     **/
    virtual bool hasTransientPlacementHint() const;
    /**
     * @returns The recommended position of the transient in parent coordinates
     **/
    virtual QPoint transientPlacementHint() const;
338 339
    const AbstractClient* transientFor() const;
    AbstractClient* transientFor();
340 341 342 343 344 345
    /**
     * @returns @c true if c is the transient_for window for this client,
     *  or recursively the transient_for window
     * @todo: remove boolean trap
     **/
    virtual bool hasTransient(const AbstractClient* c, bool indirect) const;
346
    const QList<AbstractClient*>& transients() const; // Is not indirect
Martin Flöser's avatar
Martin Flöser committed
347
    virtual void removeTransient(AbstractClient* cl);
348 349
    virtual QList<AbstractClient*> mainClients() const; // Call once before loop , is not indirect
    QList<AbstractClient*> allMainClients() const; // Call once before loop , is indirect
350 351 352 353 354 355
    /**
     * Returns true for "special" windows and false for windows which are "normal"
     * (normal=window which has a border, can be moved by the user, can be closed, etc.)
     * true for Desktop, Dock, Splash, Override and TopMenu (and Toolbar??? - for now)
     * false for Normal, Dialog, Utility and Menu (and Toolbar??? - not yet) TODO
     */
356
    bool isSpecialWindow() const;
357
    void sendToScreen(int screen);
358 359
    virtual const QKeySequence &shortcut() const  = 0;
    virtual void setShortcut(const QString &cut) = 0;
360
    virtual bool performMouseCommand(Options::MouseCommand, const QPoint &globalPos);
361 362 363 364 365
    void setOnAllDesktops(bool set);
    void setDesktop(int);
    int desktop() const override {
        return m_desktop;
    }
366 367 368 369 370 371 372 373 374
    void setMinimized(bool set);
    /**
    * Minimizes this client plus its transients
    */
    void minimize(bool avoid_animation = false);
    void unminimize(bool avoid_animation = false);
    bool isMinimized() const {
        return m_minimized;
    }
375 376 377
    virtual void setFullScreen(bool set, bool user = true) = 0;
    virtual TabGroup *tabGroup() const;
    Q_INVOKABLE virtual bool untab(const QRect &toGeometry = QRect(), bool clientRemoved = false);
378
    virtual bool isCurrentTab() const;
379
    virtual QRect geometryRestore() const = 0;
380
    virtual MaximizeMode maximizeMode() const = 0;
381 382
    void maximize(MaximizeMode);
    void setMaximize(bool vertically, bool horizontally);
383 384
    virtual bool noBorder() const = 0;
    virtual void setNoBorder(bool set) = 0;
385
    virtual void blockActivityUpdates(bool b = true) = 0;
386 387
    QPalette palette() const;
    const Decoration::DecorationPalette *decorationPalette() const;
388 389 390
    virtual bool isResizable() const = 0;
    virtual bool isMovable() const = 0;
    virtual bool isMovableAcrossScreens() const = 0;
391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409
    /**
     * @c true only for @c ShadeNormal
     **/
    bool isShade() const {
        return shadeMode() == ShadeNormal;
    }
    /**
     * Default implementation returns @c ShadeNone
     **/
    virtual ShadeMode shadeMode() const; // Prefer isShade()
    void setShade(bool set);
    /**
     * Default implementation does nothing
     **/
    virtual void setShade(ShadeMode mode);
    /**
     * Whether the Client can be shaded. Default implementation returns @c false.
     **/
    virtual bool isShadeable() const;
410 411
    virtual bool isMaximizable() const = 0;
    virtual bool isMinimizable() const = 0;
412
    virtual QRect iconGeometry() const;
413 414 415
    virtual bool userCanSetFullScreen() const = 0;
    virtual bool userCanSetNoBorder() const = 0;
    virtual void setOnAllActivities(bool set) = 0;
416
    virtual const WindowRules* rules() const = 0;
417 418
    virtual void takeFocus() = 0;
    virtual bool wantsInput() const = 0;
419 420 421 422 423 424 425 426 427 428 429 430
    /**
     * Whether a dock window wants input.
     *
     * By default KWin doesn't pass focus to a dock window unless a force activate
     * request is provided.
     *
     * This method allows to have dock windows take focus also through flags set on
     * the window.
     *
     * The default implementation returns @c false.
     **/
    virtual bool dockWantsInput() const;
431
    void checkWorkspacePosition(QRect oldGeometry = QRect(), int oldDesktop = -2,  QRect oldClientGeometry = QRect());
432
    virtual xcb_timestamp_t userTime() const;
433
    virtual void updateWindowRules(Rules::Types selection) = 0;
434

435 436 437 438
    void growHorizontal();
    void shrinkHorizontal();
    void growVertical();
    void shrinkVertical();
439
    void updateMoveResize(const QPointF &currentGlobalCursor);
440 441 442 443
    /**
     * Ends move resize when all pointer buttons are up again.
     **/
    void endMoveResize();
444
    void keyPressEvent(uint key_code);
445

446
    void enterEvent(const QPoint &globalPos);
447
    void leaveEvent();
448

449 450 451 452 453 454 455 456 457 458 459 460 461 462 463
    /**
     * These values represent positions inside an area
     */
    enum Position {
        // without prefix, they'd conflict with Qt::TopLeftCorner etc. :(
        PositionCenter         = 0x00,
        PositionLeft           = 0x01,
        PositionRight          = 0x02,
        PositionTop            = 0x04,
        PositionBottom         = 0x08,
        PositionTopLeft        = PositionLeft | PositionTop,
        PositionTopRight       = PositionRight | PositionTop,
        PositionBottomLeft     = PositionLeft | PositionBottom,
        PositionBottomRight    = PositionRight | PositionBottom
    };
464
    Position titlebarPosition() const;
465
    bool titlebarPositionUnderMouse() const;
466

467
    // a helper for the workspace window packing. tests for screen validity and updates since in maximization case as with normal moving
468
    void packTo(int left, int top);
469

470 471 472 473 474 475 476 477 478 479 480 481 482 483 484
    enum QuickTileFlag {
        QuickTileNone = 0,
        QuickTileLeft = 1,
        QuickTileRight = 1<<1,
        QuickTileTop = 1<<2,
        QuickTileBottom = 1<<3,
        QuickTileHorizontal = QuickTileLeft|QuickTileRight,
        QuickTileVertical = QuickTileTop|QuickTileBottom,
        QuickTileMaximize = QuickTileLeft|QuickTileRight|QuickTileTop|QuickTileBottom
    };
    Q_DECLARE_FLAGS(QuickTileMode, QuickTileFlag)
    /** Set the quick tile mode ("snap") of this window.
     * This will also handle preserving and restoring of window geometry as necessary.
     * @param mode The tile mode (left/right) to give this window.
     */
485 486 487 488
    void setQuickTileMode(QuickTileMode mode, bool keyboard = false);
    QuickTileMode quickTileMode() const {
        return QuickTileMode(m_quickTileMode);
    }
489 490
    Layer layer() const override;
    void updateLayer();
491

492
    enum ForceGeometry_t { NormalGeometrySet, ForceGeometrySet };
493
    void move(int x, int y, ForceGeometry_t force = NormalGeometrySet);
494
    void move(const QPoint &p, ForceGeometry_t force = NormalGeometrySet);
495 496
    virtual void resizeWithChecks(int w, int h, ForceGeometry_t force = NormalGeometrySet) = 0;
    void resizeWithChecks(const QSize& s, ForceGeometry_t force = NormalGeometrySet);
497
    void keepInArea(QRect area, bool partial = false);
498 499
    virtual QSize minSize() const;
    virtual QSize maxSize() const;
500 501
    virtual void setGeometry(int x, int y, int w, int h, ForceGeometry_t force = NormalGeometrySet) = 0;
    void setGeometry(const QRect& r, ForceGeometry_t force = NormalGeometrySet);
502 503 504 505 506 507 508
    /// How to resize the window in order to obey constains (mainly aspect ratios)
    enum Sizemode {
        SizemodeAny,
        SizemodeFixedW, ///< Try not to affect width
        SizemodeFixedH, ///< Try not to affect height
        SizemodeMax ///< Try not to make it larger in either direction
    };
509 510 511 512 513 514 515 516
    /**
     *Calculate the appropriate frame size for the given client size @p wsize.
     *
     * @p wsize is adapted according to the window's size hints (minimum, maximum and incremental size changes).
     *
     * Default implementation returns the passed in @p wsize.
     */
    virtual QSize sizeForClientSize(const QSize &wsize, Sizemode mode = SizemodeAny, bool noframe = false) const;
517

518 519 520
    QSize adjustedSize(const QSize&, Sizemode mode = SizemodeAny) const;
    QSize adjustedSize() const;

521 522 523 524 525 526
    bool isMove() const {
        return isMoveResize() && moveResizePointerMode() == PositionCenter;
    }
    bool isResize() const {
        return isMoveResize() && moveResizePointerMode() != PositionCenter;
    }
527 528 529 530 531 532
    /**
     * Cursor shape for move/resize mode.
     **/
    Qt::CursorShape cursor() const {
        return m_moveResize.cursor;
    }
533

534
    virtual bool hasStrut() const;
535

536 537 538
    void setModal(bool modal);
    bool isModal() const;

539 540 541 542 543 544 545 546 547 548
    /**
     * Determines the mouse command for the given @p button in the current state.
     *
     * The @p handled argument specifies whether the button was handled or not.
     * This value should be used to determine whether the mouse button should be
     * passed to the AbstractClient or being filtered out.
     **/
    Options::MouseCommand getMouseCommand(Qt::MouseButton button, bool *handled) const;
    Options::MouseCommand getWheelCommand(Qt::Orientation orientation, bool *handled) const;

549 550
    // decoration related
    KDecoration2::Decoration *decoration() {
551
        return m_decoration.decoration;
552 553
    }
    const KDecoration2::Decoration *decoration() const {
554
        return m_decoration.decoration;
555 556
    }
    bool isDecorated() const {
557
        return m_decoration.decoration != nullptr;
558
    }
559 560
    QPointer<Decoration::DecoratedClientImpl> decoratedClient() const;
    void setDecoratedClient(QPointer<Decoration::DecoratedClientImpl> client);
561
    bool decorationHasAlpha() const;
562
    void triggerDecorationRepaint();
563
    virtual void layoutDecorationRects(QRect &left, QRect &top, QRect &right, QRect &bottom) const;
564
    void processDecorationMove(const QPoint &localPos, const QPoint &globalPos);
565 566
    bool processDecorationButtonPress(QMouseEvent *event, bool ignoreMenu = false);
    void processDecorationButtonRelease(QMouseEvent *event);
567

568 569 570 571 572
    /**
     * TODO: fix boolean traps
     **/
    virtual void updateDecoration(bool check_workspace_pos, bool force = false) = 0;

573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592
    /**
    * Returns whether the window provides context help or not. If it does,
    * you should show a help menu item or a help button like '?' and call
    * contextHelp() if this is invoked.
    *
    * Default implementation returns @c false.
    * @see showContextHelp;
    */
    virtual bool providesContextHelp() const;

    /**
    * Invokes context help on the window. Only works if the window
    * actually provides context help.
    *
    * Default implementation does nothing.
    *
    * @see providesContextHelp()
    */
    virtual void showContextHelp();

593 594
    QRect inputGeometry() const override;

595 596 597 598 599 600 601
    /**
     * Restores the AbstractClient after it had been hidden due to show on screen edge functionality.
     * The AbstractClient also gets raised (e.g. Panel mode windows can cover) and the AbstractClient
     * gets informed in a window specific way that it is shown and raised again.
     **/
    virtual void showOnScreenEdge() = 0;

602 603 604 605 606 607
    // TODO: remove boolean trap
    static bool belongToSameApplication(const AbstractClient* c1, const AbstractClient* c2, bool active_hack = false);

public Q_SLOTS:
    virtual void closeWindow() = 0;

608
Q_SIGNALS:
609
    void fullScreenChanged();
610
    void skipTaskbarChanged();
611
    void skipPagerChanged();
612
    void skipSwitcherChanged();
613
    void iconChanged();
614
    void activeChanged();
615 616
    void keepAboveChanged(bool);
    void keepBelowChanged(bool);
617 618 619 620
    /**
     * Emitted whenever the demands attention state changes.
     **/
    void demandsAttentionChanged();
621
    void desktopPresenceChanged(KWin::AbstractClient*, int); // to be forwarded by Workspace
622
    void desktopChanged();
623
    void shadeChanged();
624 625 626
    void minimizedChanged();
    void clientMinimized(KWin::AbstractClient* client, bool animate);
    void clientUnminimized(KWin::AbstractClient* client, bool animate);
627
    void paletteChanged(const QPalette &p);
628
    void captionChanged();
629 630
    void clientMaximizedStateChanged(KWin::AbstractClient*, MaximizeMode);
    void clientMaximizedStateChanged(KWin::AbstractClient* c, bool h, bool v);
631
    void transientChanged();
632
    void modalChanged();
633
    void quickTileModeChanged();
634
    void moveResizedChanged();
635
    void moveResizeCursorChanged(Qt::CursorShape);
636 637 638
    void clientStartUserMovedResized(KWin::AbstractClient*);
    void clientStepUserMovedResized(KWin::AbstractClient *, const QRect&);
    void clientFinishUserMovedResized(KWin::AbstractClient*);
639 640 641 642
    void closeableChanged(bool);
    void minimizeableChanged(bool);
    void shadeableChanged(bool);
    void maximizeableChanged(bool);
643

644 645
protected:
    AbstractClient();
646 647 648
    void setFirstInTabBox(bool enable) {
        m_firstInTabBox = enable;
    }
649
    void setIcon(const QIcon &icon);
650 651
    void startAutoRaise();
    void autoRaise();
652 653 654 655 656 657
    /**
     * Whether the window accepts focus.
     * The difference to wantsInput is that the implementation should not check rules and return
     * what the window effectively supports.
     **/
    virtual bool acceptsFocus() const = 0;
658 659 660 661 662 663 664
    /**
     * Called from ::setActive once the active value got updated, but before the changed signal
     * is emitted.
     *
     * Default implementation does nothing.
     **/
    virtual void doSetActive();
665 666 667 668 669 670 671 672 673 674 675 676 677 678
    /**
     * Called from ::setKeepAbove once the keepBelow value got updated, but before the changed signal
     * is emitted.
     *
     * Default implementation does nothing.
     **/
    virtual void doSetKeepAbove();
    /**
     * Called from ::setKeepBelow once the keepBelow value got updated, but before the changed signal
     * is emitted.
     *
     * Default implementation does nothing.
     **/
    virtual void doSetKeepBelow();
679 680 681 682 683 684 685 686 687
    /**
     * Called from ::setDeskop once the desktop value got updated, but before the changed signal
     * is emitted.
     *
     * Default implementation does nothing.
     * @param desktop The new desktop the Client is on
     * @param was_desk The desktop the Client was on before
     **/
    virtual void doSetDesktop(int desktop, int was_desk);
688 689 690 691 692 693 694
    /**
     * Called from ::minimize and ::unminimize once the minimized value got updated, but before the
     * changed signal is emitted.
     *
     * Default implementation does nothig.
     **/
    virtual void doMinimize();
695 696
    // TODO: remove boolean trap
    virtual bool belongsToSameApplication(const AbstractClient *other, bool active_hack) const = 0;
697

698
    virtual void doSetSkipTaskbar();
699 700
    virtual void doSetSkipPager();

701 702 703
    void setupWindowManagementInterface();
    void destroyWindowManagementInterface();

704 705
    void updateColorScheme(QString path);

706
    void setTransientFor(AbstractClient *transientFor);
707 708 709 710 711
    virtual void addTransient(AbstractClient* cl);
    /**
     * Just removes the @p cl from the transients without any further checks.
     **/
    void removeTransientFromList(AbstractClient* cl);
712

713 714 715 716 717
    Layer belongsToLayer() const;
    virtual bool belongsToDesktop() const;
    void invalidateLayer();
    virtual bool isActiveFullScreen() const;
    virtual Layer layerForDock() const;
718

719 720 721 722 723
    // electric border / quick tiling
    void setElectricBorderMode(QuickTileMode mode);
    QuickTileMode electricBorderMode() const {
        return m_electricMode;
    }
724 725 726 727
    void setElectricBorderMaximizing(bool maximizing);
    bool isElectricBorderMaximizing() const {
        return m_electricMaximizing;
    }
728
    QRect electricBorderMaximizeGeometry(QPoint pos, int desktop);
729 730 731
    void updateQuickTileMode(QuickTileMode newMode) {
        m_quickTileMode = newMode;
    }
732

733 734 735 736
    KWayland::Server::PlasmaWindowInterface *windowManagementInterface() const {
        return m_windowManagementInterface;
    }

737 738
    // geometry handling
    void checkOffscreenPosition(QRect *geom, const QRect &screenArea);
739 740 741 742
    int borderLeft() const;
    int borderRight() const;
    int borderTop() const;
    int borderBottom() const;
743
    virtual void changeMaximize(bool horizontal, bool vertical, bool adjust) = 0;
744
    virtual void setGeometryRestore(const QRect &geo) = 0;
745 746 747 748 749
    /**
     * Called from move after updating the geometry. Can be reimplemented to perform specific tasks.
     * The base implementation does nothing.
     **/
    virtual void doMove(int x, int y);
750 751 752 753 754 755 756 757 758 759 760
    void blockGeometryUpdates(bool block);
    void blockGeometryUpdates();
    void unblockGeometryUpdates();
    bool areGeometryUpdatesBlocked() const;
    enum PendingGeometry_t {
        PendingGeometryNone,
        PendingGeometryNormal,
        PendingGeometryForced
    };
    PendingGeometry_t pendingGeometryUpdate() const;
    void setPendingGeometryUpdate(PendingGeometry_t update);
761 762 763 764
    QRect geometryBeforeUpdateBlocking() const {
        return m_geometryBeforeUpdateBlocking;
    }
    void updateGeometryBeforeUpdateBlocking();
765 766 767 768 769 770
    /**
     * Schedules a repaint for the visibleRect before and after a
     * geometry update. The current visibleRect is stored for the
     * next time this method is called as the before geometry.
     **/
    void addRepaintDuringGeometryUpdates();
771

772 773 774 775 776 777 778
    /**
     * Convenient method to update the TabGroup states if there is one present.
     * Marked as virtual as TabGroup does not yet handle AbstractClient, but only
     * subclasses of AbstractClient. Given that the default implementation does nothing.
     **/
    virtual void updateTabGroupStates(TabGroup::States states);

779 780 781 782 783 784 785 786 787 788 789 790
    /**
     * @returns whether the Client is currently in move resize mode
     **/
    bool isMoveResize() const {
        return m_moveResize.enabled;
    }
    /**
     * Sets whether the Client is in move resize mode to @p enabled.
     **/
    void setMoveResize(bool enabled) {
        m_moveResize.enabled = enabled;
    }
791 792 793 794 795 796 797 798 799 800 801 802
    /**
     * @returns whether the move resize mode is unrestricted.
     **/
    bool isUnrestrictedMoveResize() const {
        return m_moveResize.unrestricted;
    }
    /**
     * Sets whether move resize mode is unrestricted to @p set.
     **/
    void setUnrestrictedMoveResize(bool set) {
        m_moveResize.unrestricted = set;
    }
803 804 805 806 807 808 809 810 811 812 813 814
    QPoint moveOffset() const {
        return m_moveResize.offset;
    }
    void setMoveOffset(const QPoint &offset) {
        m_moveResize.offset = offset;
    }
    QPoint invertedMoveOffset() const {
        return m_moveResize.invertedOffset;
    }
    void setInvertedMoveOffset(const QPoint &offset) {
        m_moveResize.invertedOffset = offset;
    }
815 816 817 818 819 820 821
    QRect initialMoveResizeGeometry() const {
        return m_moveResize.initialGeometry;
    }
    /**
     * Sets the initial move resize geometry to the current geometry.
     **/
    void updateInitialMoveResizeGeometry();
822 823 824 825 826 827
    QRect moveResizeGeometry() const {
        return m_moveResize.geometry;
    }
    void setMoveResizeGeometry(const QRect &geo) {
        m_moveResize.geometry = geo;
    }
828 829 830 831 832 833
    Position moveResizePointerMode() const {
        return m_moveResize.pointer;
    }
    void setMoveResizePointerMode(Position mode) {
        m_moveResize.pointer = mode;
    }
834 835 836 837 838 839
    bool isMoveResizePointerButtonDown() const {
        return m_moveResize.buttonDown;
    }
    void setMoveResizePointerButtonDown(bool down) {
        m_moveResize.buttonDown = down;
    }
840 841 842
    int moveResizeStartScreen() const {
        return m_moveResize.startScreen;
    }
843
    void checkUnrestrictedMoveResize();
844 845 846 847
    /**
    * Sets an appropriate cursor shape for the logical mouse position.
    */
    void updateCursor();
848 849
    void startDelayedMoveResize();
    void stopDelayedMoveResize();
850 851 852 853 854 855 856 857 858 859
    bool startMoveResize();
    /**
     * Called from @link startMoveResize.
     *
     * Implementing classes should return @c false if starting move resize should
     * get aborted. In that case @link startMoveResize will also return @c false.
     *
     * Base implementation returns @c true.
     **/
    virtual bool doStartMoveResize();
860
    void finishMoveResize(bool cancel);
861 862 863 864 865 866 867
    /**
     * Leaves the move resize mode.
     *
     * Inheriting classes must invoke the base implementation which
     * ensures that the internal mode is properly ended.
     **/
    virtual void leaveMoveResize();
868
    virtual void positionGeometryTip();
869 870 871 872 873 874 875 876
    void performMoveResize();
    /**
     * Called from performMoveResize() after actually performing the change of geometry.
     * Implementing subclasses can perform windowing system specific handling here.
     *
     * Default implementation does nothing.
     **/
    virtual void doPerformMoveResize();
877 878 879 880 881
    /*
     * Checks if the mouse cursor is near the edge of the screen and if so
     * activates quick tiling or maximization
     */
    void checkQuickTilingMaximizationZones(int xroot, int yroot);
882 883 884 885 886 887 888 889 890 891 892 893 894 895
    /**
     * Whether a sync request is still pending.
     * Default implementation returns @c false.
     **/
    virtual bool isWaitingForMoveResizeSync() const;
    /**
     * Called during handling a resize. Implementing subclasses can use this
     * method to perform windowing system specific syncing.
     *
     * Default implementation does nothing.
     **/
    virtual void doResizeSync();
    void handleMoveResize(int x, int y, int x_root, int y_root);
    void handleMoveResize(const QPoint &local, const QPoint &global);
896
    void dontMoveResize();
897

898 899
    virtual QSize resizeIncrements() const;

900
    /**
901 902
     * Returns the position depending on the Decoration's section under mouse.
     * If no decoration it returns PositionCenter.
903
     **/
904
    Position mousePosition() const;
905

906 907 908 909 910 911 912 913
    static bool haveResizeEffect() {
        return s_haveResizeEffect;
    }
    static void updateHaveResizeEffect();
    static void resetHaveResizeEffect() {
        s_haveResizeEffect = false;
    }

914
    void setDecoration(KDecoration2::Decoration *decoration) {
915
        m_decoration.decoration = decoration;
916 917
    }
    virtual void destroyDecoration();
918
    void startDecorationDoubleClickTimer();
919
    void invalidateDecorationDoubleClickTimer();
920

921
private:
922
    void handlePaletteChange();
923
    QSharedPointer<TabBox::TabBoxClientImpl> m_tabBoxClient;
924
    bool m_firstInTabBox = false;
925 926 927 928 929
    bool m_skipTaskbar = false;
    /**
     * Unaffected by KWin
     **/
    bool m_originalSkipTaskbar = false;
930
    bool m_skipPager = false;
931
    bool m_skipSwitcher = false;
932
    QIcon m_icon;
933
    bool m_active = false;
934 935
    bool m_keepAbove = false;
    bool m_keepBelow = false;
936
    bool m_demandsAttention = false;
937
    bool m_minimized = false;
938
    QTimer *m_autoRaiseTimer = nullptr;
939
    int m_desktop = 0; // 0 means not on any desktop yet
940 941 942 943 944

    QString m_colorScheme;
    std::shared_ptr<Decoration::DecorationPalette> m_palette;
    static QHash<QString, std::weak_ptr<Decoration::DecorationPalette>> s_palettes;
    static std::shared_ptr<Decoration::DecorationPalette> s_defaultPalette;
945 946

    KWayland::Server::PlasmaWindowInterface *m_windowManagementInterface = nullptr;
947 948

    AbstractClient *m_transientFor = nullptr;
949
    QList<AbstractClient*> m_transients;
950
    bool m_modal = false;
951
    Layer m_layer = UnknownLayer;
952 953 954

    // electric border/quick tiling
    QuickTileMode m_electricMode = QuickTileNone;
955
    bool m_electricMaximizing = false;
956 957 958
    /** The quick tile mode of this window.
     */
    int m_quickTileMode = QuickTileNone;
959
    QTimer *m_electricMaximizingDelay = nullptr;
960 961 962 963 964

    // geometry
    int m_blockGeometryUpdates = 0; // > 0 = New geometry is remembered, but not actually set
    PendingGeometry_t m_pendingGeometryUpdate = PendingGeometryNone;
    friend class GeometryUpdatesBlocker;
965
    QRect m_visibleRectBeforeGeometryUpdate;
966
    QRect m_geometryBeforeUpdateBlocking;
967 968 969

    struct {
        bool enabled = false;
970
        bool unrestricted = false;
971 972
        QPoint offset;
        QPoint invertedOffset;
973
        QRect initialGeometry;
974
        QRect geometry;
975
        Position pointer = PositionCenter;
976
        bool buttonDown = false;
977
        Qt::CursorShape cursor = Qt::ArrowCursor;
978
        int startScreen = 0;
979
        QTimer *delayedTimer = nullptr;
980
    } m_moveResize;
981

982 983 984 985 986
    struct {
        KDecoration2::Decoration *decoration = nullptr;
        QPointer<Decoration::DecoratedClientImpl> client;
        QElapsedTimer doubleClickTimer;
    } m_decoration;
987

988 989

    static bool s_haveResizeEffect;
990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007
};

/**
 * Helper for AbstractClient::blockGeometryUpdates() being called in pairs (true/false)
 */
class GeometryUpdatesBlocker
{
public:
    explicit GeometryUpdatesBlocker(AbstractClient* c)
        : cl(c) {
        cl->blockGeometryUpdates(true);
    }
    ~GeometryUpdatesBlocker() {
        cl->blockGeometryUpdates(false);
    }

private:
    AbstractClient* cl;
1008 1009
};

1010 1011 1012 1013 1014
inline void AbstractClient::move(const QPoint& p, ForceGeometry_t force)
{
    move(p.x(), p.y(), force);
}

1015 1016 1017 1018 1019
inline void AbstractClient::resizeWithChecks(const QSize& s, AbstractClient::ForceGeometry_t force)
{
    resizeWithChecks(s.width(), s.height(), force);
}

1020 1021 1022 1023 1024
inline void AbstractClient::setGeometry(const QRect& r, ForceGeometry_t force)
{
    setGeometry(r.x(), r.y(), r.width(), r.height(), force);
}

1025 1026 1027 1028 1029
inline const QList<AbstractClient*>& AbstractClient::transients() const
{
    return m_transients;
}

1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054
inline bool AbstractClient::areGeometryUpdatesBlocked() const
{
    return m_blockGeometryUpdates != 0;
}

inline void AbstractClient::blockGeometryUpdates()
{
    m_blockGeometryUpdates++;
}

inline void AbstractClient::unblockGeometryUpdates()
{
    m_blockGeometryUpdates--;
}

inline AbstractClient::PendingGeometry_t AbstractClient::pendingGeometryUpdate() const
{
    return m_pendingGeometryUpdate;
}

inline void AbstractClient::setPendingGeometryUpdate(PendingGeometry_t update)
{
    m_pendingGeometryUpdate = update;
}

1055 1056 1057 1058
}

Q_DECLARE_METATYPE(KWin::AbstractClient*)
Q_DECLARE_METATYPE(QList<KWin::AbstractClient*>)
1059
Q_DECLARE_OPERATORS_FOR_FLAGS(KWin::AbstractClient::QuickTileMode)
1060 1061

#endif