b73d90cf78
A new enum is introduced which defines all the buttons known to KWin. The defaultTitleButton methods return a list of DecorationButtons instead of a string which needs to be parsed by the decoration. The same for the actual title buttons. The reading/storing of the buttons is unchanged, that is the same characters are used and mapped to the button types.
499 lines
17 KiB
C++
499 lines
17 KiB
C++
/*
|
|
This file is part of the KDE project.
|
|
|
|
Copyright (C) 2005 Sandro Giessl <sandro@giessl.com>
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a
|
|
copy of this software and associated documentation files (the "Software"),
|
|
to deal in the Software without restriction, including without limitation
|
|
the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
|
and/or sell copies of the Software, and to permit persons to whom the
|
|
Software is furnished to do so, subject to the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be included in
|
|
all copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
|
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
|
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
|
|
DEALINGS IN THE SOFTWARE.
|
|
*/
|
|
|
|
#ifndef KCOMMONDECORATION_H
|
|
#define KCOMMONDECORATION_H
|
|
|
|
#include <QAbstractButton>
|
|
#include "kdecoration.h"
|
|
|
|
/** @addtogroup kdecoration */
|
|
/** @{ */
|
|
|
|
class KDecorationBridge;
|
|
class KDecorationFactory;
|
|
|
|
enum ButtonType {
|
|
HelpButton = 0,
|
|
MaxButton,
|
|
MinButton,
|
|
CloseButton,
|
|
MenuButton,
|
|
OnAllDesktopsButton,
|
|
AboveButton,
|
|
BelowButton,
|
|
ShadeButton,
|
|
AppMenuButton,
|
|
NumButtons,
|
|
ItemCloseButton = 100, // Close only one tab
|
|
ItemMenuButton // shows the window menu for one tab
|
|
};
|
|
|
|
class KCommonDecorationButton;
|
|
|
|
class KCommonDecorationButtonPrivate;
|
|
class KCommonDecorationPrivate;
|
|
class KCommonDecorationWrapper;
|
|
|
|
/**
|
|
* This class eases development of decorations by implementing parts of KDecoration
|
|
* which are error prone and common for most decorations.
|
|
* It takes care of the window layout, button/action handling, and window mask creation.
|
|
* Note that for technical reasons KCommonDecoration does not inherit KDecoration but
|
|
* only provides the same API. If in rare cases you need to convert to KDecoration,
|
|
* use the decoration() function.
|
|
* See KDecoration documentation for all the wrapped functions.
|
|
*/
|
|
class KWIN_EXPORT KCommonDecoration : public QObject, public KDecorationDefines
|
|
{
|
|
Q_OBJECT
|
|
|
|
public:
|
|
KCommonDecoration(KDecorationBridge* bridge, KDecorationFactory* factory);
|
|
virtual ~KCommonDecoration();
|
|
|
|
/**
|
|
* Used to calculate the decoration layout. The basic layout looks like this:
|
|
*
|
|
* Window:
|
|
* _______________________________________________________________
|
|
* | LM_TitleEdgeTop |
|
|
* |_______________________________________________________________|
|
|
* | LM_TitleEdgeLeft | [title] | LM_TitleEdgeRight |
|
|
* |__________________|________________________|___________________|
|
|
* | LM_TitleEdgeBottom |
|
|
* |_______________________________________________________________|
|
|
* | | | |
|
|
* | | | |
|
|
* | | | |
|
|
* |LM_BorderLeft LM_BorderRight|
|
|
* |_|___________________________________________________________|_|
|
|
* | LM_BorderBottom |
|
|
* |_______________________________________________________________|
|
|
*
|
|
* Title:
|
|
* ___________________________________________________________________________________
|
|
* | LM_ButtonMarginTop | | LM_ButtonMarginTop |
|
|
* |________________________________| |_________________________________|
|
|
* | [Buttons] | LM_TitleBorderLeft | LM_TitleHeight | LM_TitleBorderRight | [Buttons] |
|
|
* |___________|____________________|________________|_____________________|___________|
|
|
*
|
|
* Buttons:
|
|
* _____________________________________________________________________________________________
|
|
* | button | spacing | button | spacing | explicit spacer | spacing | ... | spacing | button |
|
|
* |________|_________|________|_________|_________________|_________|________|_________|________|
|
|
*
|
|
* @see layoutMetric()
|
|
*/
|
|
enum LayoutMetric {
|
|
LM_BorderLeft,
|
|
LM_BorderRight,
|
|
LM_BorderBottom,
|
|
LM_TitleHeight,
|
|
LM_TitleBorderLeft,
|
|
LM_TitleBorderRight,
|
|
LM_TitleEdgeLeft,
|
|
LM_TitleEdgeRight,
|
|
LM_TitleEdgeTop,
|
|
LM_TitleEdgeBottom,
|
|
LM_ButtonWidth,
|
|
LM_ButtonHeight,
|
|
LM_ButtonSpacing,
|
|
LM_ExplicitButtonSpacer,
|
|
LM_ButtonMarginTop,
|
|
LM_OuterPaddingLeft, ///< @since 4.3
|
|
LM_OuterPaddingTop, ///< @since 4.3
|
|
LM_OuterPaddingRight, ///< @since 4.3
|
|
LM_OuterPaddingBottom ///< @since 4.4
|
|
};
|
|
|
|
enum DecorationBehaviour {
|
|
DB_MenuClose, ///< Close window on double clicking the menu
|
|
DB_WindowMask, ///< Set a mask on the window
|
|
DB_ButtonHide ///< Hide buttons when there is not enough space in the titlebar
|
|
};
|
|
|
|
enum WindowCorner {
|
|
WC_TopLeft,
|
|
WC_TopRight,
|
|
WC_BottomLeft,
|
|
WC_BottomRight
|
|
};
|
|
|
|
/**
|
|
* The name of the decoration used in the decoration preview.
|
|
*/
|
|
virtual QString visibleName() const = 0;
|
|
|
|
/**
|
|
* This controls whether some specific behaviour should be enabled or not.
|
|
* @see DecorationBehaviour
|
|
*/
|
|
virtual bool decorationBehaviour(DecorationBehaviour behaviour) const;
|
|
|
|
/**
|
|
* This controls the layout of the decoration in various ways. It is
|
|
* possible to have a different layout for different window states.
|
|
* @param lm The layout element.
|
|
* @param respectWindowState Whether window states should be taken into account or a "default" state should be assumed.
|
|
* @param button For LM_ButtonWidth and LM_ButtonHeight, the button.
|
|
*/
|
|
virtual int layoutMetric(LayoutMetric lm, bool respectWindowState = true, const KCommonDecorationButton *button = 0) const;
|
|
|
|
/**
|
|
* Create a new title bar button. KCommonDecoration takes care of memory management.
|
|
* @return a pointer to the button, or 0 if the button should not be created.
|
|
*/
|
|
virtual KCommonDecorationButton *createButton(ButtonType type) = 0;
|
|
|
|
/**
|
|
* @return the mask for the specific window corner.
|
|
*/
|
|
virtual QRegion cornerShape(WindowCorner corner);
|
|
|
|
/**
|
|
* This updates the window mask using the information provided by
|
|
* cornerShape(). Edges which are aligned to screen corners are not
|
|
* shaped for better usability (remember to paint these areas in paintEvent(), too).
|
|
* You normally don't want/need to reimplement updateWindowShape().
|
|
* @see cornerShape()
|
|
*/
|
|
virtual void updateWindowShape();
|
|
|
|
/**
|
|
* Draw the window decoration.
|
|
*/
|
|
virtual void paintEvent(QPaintEvent *e) = 0;
|
|
|
|
/**
|
|
* This is used to update the painting of the title bar after the caption has been changed.
|
|
* Reimplement for a more efficient implementation (default calls update() on the whole decoration).
|
|
*/
|
|
virtual void updateCaption();
|
|
|
|
int buttonsLeftWidth() const;
|
|
int buttonsRightWidth() const;
|
|
|
|
/**
|
|
* TODO: remove?
|
|
*/
|
|
void updateLayout() const;
|
|
/**
|
|
* Makes sure all buttons are repainted.
|
|
*/
|
|
void updateButtons() const;
|
|
/**
|
|
* Manually call reset() on each button.
|
|
*/
|
|
void resetButtons() const;
|
|
|
|
/**
|
|
* Convenience method.
|
|
* @returns true if the window type is NET::Toolbar, NET::Utility, or NET::Menu
|
|
*/
|
|
bool isToolWindow() const;
|
|
/**
|
|
* Convenience method.
|
|
* @returns the title rect.
|
|
*/
|
|
QRect titleRect() const;
|
|
|
|
/**
|
|
* Returns the rectangle within the decoration that should be transparent.
|
|
*
|
|
* Usually this is the rectangle occupied by the client window,
|
|
* but a smaller rectangle may be returned if the client has specified
|
|
* that the window decoration should extend below the client area.
|
|
*
|
|
* If the client has requested that the decoration should cover the whole
|
|
* client area, a null rectangle is returned.
|
|
*
|
|
* The returned rectangle is never larger than the client area.
|
|
*
|
|
* @since 4.4
|
|
*/
|
|
QRect transparentRect() const;
|
|
|
|
public:
|
|
/**
|
|
* Handles widget and layout creation, call the base implementation when subclassing this member.
|
|
*/
|
|
virtual void init();
|
|
virtual void borders(int& left, int& right, int& top, int& bottom) const;
|
|
virtual void show();
|
|
virtual void resize(const QSize& s);
|
|
virtual QSize minimumSize() const;
|
|
public Q_SLOTS:
|
|
virtual void activeChange();
|
|
virtual void captionChange();
|
|
virtual void desktopChange();
|
|
virtual void shadeChange();
|
|
virtual void iconChange();
|
|
virtual void maximizeChange();
|
|
void keepAboveChange(bool above);
|
|
void keepBelowChange(bool below);
|
|
void slotMaximize();
|
|
void slotShade();
|
|
void slotKeepAbove();
|
|
void slotKeepBelow();
|
|
void menuButtonPressed();
|
|
void menuButtonReleased();
|
|
void appMenuButtonPressed();
|
|
void slotAppMenuAvailable();
|
|
void slotAppMenuUnavailable();
|
|
public:
|
|
virtual Position mousePosition(const QPoint &point) const;
|
|
|
|
virtual bool eventFilter(QObject* o, QEvent* e);
|
|
virtual void resizeEvent(QResizeEvent *e);
|
|
virtual void mouseDoubleClickEvent(QMouseEvent *e);
|
|
virtual void wheelEvent(QWheelEvent *e);
|
|
|
|
// *** wrap everything from KDecoration *** //
|
|
// reimplementing from KDecoration (wrapped)
|
|
virtual bool drawbound(const QRect& geom, bool clear);
|
|
virtual bool windowDocked(Position side);
|
|
// wrap everything KDecoration provides
|
|
static const KDecorationOptions* options();
|
|
bool isActive() const;
|
|
bool isCloseable() const;
|
|
bool isMaximizable() const;
|
|
MaximizeMode maximizeMode() const;
|
|
bool isMinimizable() const;
|
|
bool providesContextHelp() const;
|
|
int desktop() const;
|
|
bool isOnAllDesktops() const; // convenience
|
|
bool isModal() const;
|
|
bool isShadeable() const;
|
|
bool isShade() const;
|
|
bool isSetShade() const;
|
|
bool keepAbove() const;
|
|
bool keepBelow() const;
|
|
bool isMovable() const;
|
|
bool isResizable() const;
|
|
NET::WindowType windowType(unsigned long supported_types) const;
|
|
QIcon icon() const;
|
|
QString caption() const;
|
|
void showWindowMenu(const QRect &pos);
|
|
void showWindowMenu(QPoint pos);
|
|
void performWindowOperation(WindowOperation op);
|
|
void setMask(const QRegion& reg, int mode = 0);
|
|
void clearMask(); // convenience
|
|
bool isPreview() const;
|
|
QRect geometry() const;
|
|
QRect iconGeometry() const;
|
|
QRegion unobscuredRegion(const QRegion& r) const;
|
|
WId windowId() const;
|
|
int width() const; // convenience
|
|
int height() const; // convenience
|
|
void processMousePressEvent(QMouseEvent* e);
|
|
|
|
bool compositingActive() const;
|
|
|
|
// Window tabbing
|
|
QString caption(int idx) const;
|
|
void closeTab(long id);
|
|
void closeTabGroup();
|
|
long currentTabId() const;
|
|
QIcon icon(int idx) const;
|
|
void setCurrentTab(long id);
|
|
void showWindowMenu(const QPoint &, long id);
|
|
void tab_A_before_B(long A, long B);
|
|
void tab_A_behind_B(long A, long B);
|
|
int tabCount() const;
|
|
long tabId(int idx) const;
|
|
void untab(long id, const QRect& newGeom);
|
|
|
|
WindowOperation buttonToWindowOperation(Qt::MouseButtons button);
|
|
|
|
Q_SIGNALS:
|
|
void keepAboveChanged(bool);
|
|
void keepBelowChanged(bool);
|
|
/**
|
|
* This signal is emitted whenever the decorated Client indicated that the
|
|
* available buttons should change (e.g. a closeable window becomes non
|
|
* closable).
|
|
*
|
|
* An implementing class should connect to this signal if it wants to update
|
|
* the buttons accordingly.
|
|
**/
|
|
void decorationButtonsChanged();
|
|
public:
|
|
void setMainWidget(QWidget*);
|
|
void createMainWidget(Qt::WindowFlags flags = 0);
|
|
Qt::WindowFlags initialWFlags() const;
|
|
QWidget* widget();
|
|
const QWidget* widget() const;
|
|
KDecorationFactory* factory() const;
|
|
void grabXServer();
|
|
void ungrabXServer();
|
|
public Q_SLOTS:
|
|
void closeWindow();
|
|
void maximize(Qt::MouseButtons button);
|
|
void maximize(MaximizeMode mode);
|
|
void minimize();
|
|
void showContextHelp();
|
|
void setDesktop(int desktop);
|
|
void toggleOnAllDesktops(); // convenience
|
|
void titlebarDblClickOperation();
|
|
void titlebarMouseWheelOperation(int delta);
|
|
void setShade(bool set);
|
|
void setKeepAbove(bool set);
|
|
void setKeepBelow(bool set);
|
|
void update();
|
|
void update(const QRect &rect);
|
|
void update(const QRegion ®ion);
|
|
// *** end of wrapping of everything from KDecoration *** //
|
|
public:
|
|
// access the KDecoration wrapper
|
|
const KDecoration* decoration() const;
|
|
KDecoration* decoration();
|
|
|
|
protected:
|
|
virtual void timerEvent(QTimerEvent *event);
|
|
|
|
protected Q_SLOTS:
|
|
/**
|
|
* A decoration providing AbilityAnnounceAlphaChannel can use this method to enable/disable the
|
|
* use of alpha channel. This is useful if for a normal window the decoration renders its own
|
|
* shadows or round corners and thus needs alpha channel. But in maximized state the decoration
|
|
* is fully opaque. By disabling the alpha channel the Compositor can optimize the rendering.
|
|
*
|
|
* @param enabled If @c true alpha channel is enabled, if @c false alpha channel is disabled
|
|
* @see KDecoration::setAlphaEnabled
|
|
* @since 4.10
|
|
**/
|
|
void setAlphaEnabled(bool enabled);
|
|
|
|
private Q_SLOTS:
|
|
/* look out for buttons that have been destroyed. */
|
|
void objDestroyed(QObject *obj);
|
|
void buttonsChanged();
|
|
|
|
/**
|
|
* This slot can be reimplemented to return the regions defined
|
|
* by KDecorationDefines::Region.
|
|
*
|
|
* The default implementation always returns an empty region.
|
|
*
|
|
* @since 4.10
|
|
*/
|
|
QRegion region(KDecorationDefines::Region r);
|
|
|
|
private:
|
|
void resetLayout();
|
|
|
|
void moveWidget(int x, int y, QWidget *widget) const;
|
|
void resizeWidget(int w, int h, QWidget *widget) const;
|
|
void doShowWindowMenu();
|
|
|
|
typedef QVector <KCommonDecorationButton*> ButtonContainer; ///< If the entry is 0, it's a spacer.
|
|
int buttonContainerWidth(const ButtonContainer &btnContainer, bool countHidden = false) const;
|
|
void addButtons(ButtonContainer &btnContainer, const QList<DecorationButton>& buttons, bool isLeft);
|
|
|
|
// button hiding for small windows
|
|
void calcHiddenButtons();
|
|
|
|
const QScopedPointer<KCommonDecorationPrivate> d;
|
|
friend class KCommonDecorationPrivate;
|
|
};
|
|
|
|
/**
|
|
* Title bar buttons of KCommonDecoration need to inherit this class.
|
|
*/
|
|
class KWIN_EXPORT KCommonDecorationButton : public QAbstractButton
|
|
{
|
|
Q_OBJECT
|
|
|
|
friend class KCommonDecoration;
|
|
|
|
public:
|
|
KCommonDecorationButton(ButtonType type, KCommonDecoration *parent);
|
|
virtual ~KCommonDecorationButton();
|
|
|
|
/**
|
|
* These flags specify what has changed, e.g. the reason for a reset().
|
|
*/
|
|
enum {
|
|
ManualReset = 1 << 0, ///< The button might want to do a full reset for some reason...
|
|
SizeChange = 1 << 1, ///< The button size changed @see setSize()
|
|
ToggleChange = 1 << 2, ///< The button toggle state has changed @see setToggleButton()
|
|
StateChange = 1 << 3, ///< The button has been set pressed or not... @see setOn()
|
|
IconChange = 1 << 4, ///< The window icon has been changed
|
|
DecorationReset = 1 << 5 ///< E.g. when decoration colors have changed
|
|
};
|
|
/**
|
|
* Initialize the button after size change etc.
|
|
*/
|
|
virtual void reset(unsigned long changed) = 0;
|
|
/**
|
|
* @returns the KCommonDecoration the button belongs to.
|
|
*/
|
|
KCommonDecoration *decoration() const;
|
|
/**
|
|
* @returns the button type.
|
|
* @see ButtonType
|
|
*/
|
|
ButtonType type() const;
|
|
|
|
/**
|
|
* Whether the button is left of the titlebar or not.
|
|
*/
|
|
bool isLeft() const;
|
|
|
|
/**
|
|
* Set which mouse buttons the button should honor. Used e.g. to prevent accidental right mouse clicks.
|
|
*/
|
|
void setRealizeButtons(int btns);
|
|
/**
|
|
* Set the button size.
|
|
*/
|
|
void setSize(const QSize &s);
|
|
/**
|
|
* Set/update the button's tool tip
|
|
*/
|
|
void setTipText(const QString &tip);
|
|
/**
|
|
* The mouse button that has been clicked last time.
|
|
*/
|
|
Qt::MouseButtons lastMousePress() const;
|
|
|
|
QSize sizeHint() const;
|
|
|
|
protected:
|
|
void setToggleButton(bool toggle);
|
|
void setOn(bool on);
|
|
void setLeft(bool left);
|
|
void mousePressEvent(QMouseEvent *e);
|
|
void mouseReleaseEvent(QMouseEvent *e);
|
|
|
|
private:
|
|
const QScopedPointer<KCommonDecorationButtonPrivate> d;
|
|
};
|
|
|
|
/** @} */
|
|
|
|
#endif // KCOMMONDECORATION_H
|
|
|
|
// kate: space-indent on; indent-width 4; mixedindent off; indent-mode cstyle;
|