1185 lines
42 KiB
C++
1185 lines
42 KiB
C++
/*****************************************************************
|
|
This file is part of the KDE project.
|
|
|
|
Copyright (C) 2003 Lubos Lunak <l.lunak@kde.org>
|
|
|
|
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 KDECORATION_H
|
|
#define KDECORATION_H
|
|
|
|
#include <QtGui/QColor>
|
|
#include <QtGui/QFont>
|
|
#include <QtCore/QObject>
|
|
#include <QtGui/QIcon>
|
|
#include <netwm_def.h>
|
|
#include <QtGui/QMouseEvent>
|
|
|
|
#define KWIN_EXPORT KDE_EXPORT
|
|
|
|
#define KWIN_DECORATION_API_VERSION 1
|
|
|
|
/**
|
|
* Defines the class to be used for decoration factory.
|
|
* The class must be namespace complete.
|
|
* E.g. KWIN_EFFECT( Oxygen::Factory )
|
|
**/
|
|
#define KWIN_DECORATION( classname ) \
|
|
extern "C" { \
|
|
KWIN_EXPORT KDecorationFactory* create_factory() { return new classname(); } \
|
|
KWIN_EXPORT int decoration_version() { return KWIN_DECORATION_API_VERSION; } \
|
|
}
|
|
|
|
class KConfig;
|
|
|
|
/** @defgroup kdecoration KWin decorations library */
|
|
|
|
/** @addtogroup kdecoration */
|
|
/** @{ */
|
|
|
|
class KDecorationOptionsPrivate;
|
|
class KDecorationBridge;
|
|
class KDecorationPrivate;
|
|
class KDecorationFactory;
|
|
|
|
/**
|
|
* This class provides a namespace for all decoration related classes.
|
|
* All shared types are defined here.
|
|
*/
|
|
class KWIN_EXPORT KDecorationDefines
|
|
{
|
|
public:
|
|
/**
|
|
* 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
|
|
};
|
|
/**
|
|
* Maximize mode. These values specify how a window is maximized.
|
|
*/
|
|
// these values are written to session files, don't change the order
|
|
enum MaximizeMode {
|
|
MaximizeRestore = 0, ///< The window is not maximized in any direction.
|
|
MaximizeVertical = 1, ///< The window is maximized vertically.
|
|
MaximizeHorizontal = 2, ///< The window is maximized horizontally.
|
|
/// Equal to @p MaximizeVertical | @p MaximizeHorizontal
|
|
MaximizeFull = MaximizeVertical | MaximizeHorizontal
|
|
};
|
|
|
|
enum WindowOperation {
|
|
MaximizeOp = 5000,
|
|
RestoreOp,
|
|
MinimizeOp,
|
|
MoveOp,
|
|
UnrestrictedMoveOp,
|
|
ResizeOp,
|
|
UnrestrictedResizeOp,
|
|
CloseOp,
|
|
OnAllDesktopsOp,
|
|
ShadeOp,
|
|
KeepAboveOp,
|
|
KeepBelowOp,
|
|
OperationsOp,
|
|
WindowRulesOp,
|
|
ToggleStoreSettingsOp = WindowRulesOp, ///< @obsolete
|
|
HMaximizeOp,
|
|
VMaximizeOp,
|
|
LowerOp,
|
|
FullScreenOp,
|
|
NoBorderOp,
|
|
NoOp,
|
|
SetupWindowShortcutOp,
|
|
ApplicationRulesOp,
|
|
RemoveTabFromGroupOp, // Remove from group
|
|
CloseTabGroupOp, // Close the group
|
|
ActivateNextTabOp, // Move left in the group
|
|
ActivatePreviousTabOp, // Move right in the group
|
|
///< @deprecated, tiling got removed in 4.10
|
|
ToggleClientTiledStateOp, // put a floating client into tiling
|
|
TabDragOp,
|
|
|
|
//BEGIN ABI stability stuff
|
|
// NOTICE for ABI stability
|
|
// TODO remove with mandatory version tagging fo 4.9.x or 4.10
|
|
/** @deprecated ABI compatibility only - don't use */
|
|
RemoveClientFromGroupOp = RemoveTabFromGroupOp, // Remove from group
|
|
CloseClientGroupOp = CloseTabGroupOp, // Close the group
|
|
MoveClientInGroupLeftOp = ActivateNextTabOp, // Move left in the group
|
|
MoveClientInGroupRightOp = ActivatePreviousTabOp // Move right in the group
|
|
//END ABI stability stuff
|
|
};
|
|
/**
|
|
* Basic color types that should be recognized by all decoration styles.
|
|
* Decorations are not required to implement all the colors, but for the ones that
|
|
* are implemented the color setting for them should be obeyed.
|
|
*/
|
|
enum ColorType {
|
|
ColorTitleBar, ///< The color for the titlebar
|
|
ColorTitleBlend, ///< The blend color for the titlebar
|
|
ColorFont, ///< The titlebar text color
|
|
ColorButtonBg, ///< The color to use for the titlebar buttons
|
|
ColorFrame, ///< The color for the window frame (border)
|
|
ColorHandle, ///< The color for the resize handle
|
|
NUM_COLORS ///< @internal This value may change, do not use
|
|
};
|
|
|
|
/**
|
|
* These flags specify which settings changed when rereading settings.
|
|
* Each setting in class KDecorationOptions specifies its matching flag.
|
|
*/
|
|
enum {
|
|
SettingDecoration = 1 << 0, ///< The decoration was changed
|
|
SettingColors = 1 << 1, ///< The color palette was changed
|
|
SettingFont = 1 << 2, ///< The titlebar font was changed
|
|
SettingButtons = 1 << 3, ///< The button layout was changed
|
|
SettingTooltips = 1 << 4, ///< The tooltip setting was changed
|
|
SettingBorder = 1 << 5, ///< The border size setting was changed
|
|
SettingCompositing = 1 << 6 ///< Compositing settings was changed
|
|
};
|
|
|
|
/**
|
|
* Border size. KDecorationOptions::preferredBorderSize() returns
|
|
* one of these values.
|
|
*/
|
|
enum BorderSize {
|
|
BorderTiny, ///< Minimal borders
|
|
BorderNormal, ///< Standard size borders, the default setting
|
|
BorderLarge, ///< Larger borders
|
|
BorderVeryLarge, ///< Very large borders
|
|
BorderHuge, ///< Huge borders
|
|
BorderVeryHuge, ///< Very huge borders
|
|
BorderOversized, ///< Oversized borders
|
|
BordersCount ///< @internal
|
|
};
|
|
|
|
/**
|
|
* Used to find out which features the decoration supports.
|
|
* @see KDecorationFactory::supports()
|
|
*/
|
|
enum Ability {
|
|
// announce
|
|
AbilityAnnounceButtons = 0, ///< decoration supports AbilityButton* values (always use)
|
|
AbilityAnnounceColors = 1, ///< decoration supports AbilityColor* values (always use), @deprecated @todo remove KDE5
|
|
// buttons
|
|
AbilityButtonMenu = 1000, ///< decoration supports the window menu button
|
|
AbilityButtonOnAllDesktops = 1001, ///< decoration supports the on all desktops button
|
|
AbilityButtonSpacer = 1002, ///< decoration supports inserting spacers between buttons
|
|
AbilityButtonHelp = 1003, ///< decoration supports what's this help button
|
|
AbilityButtonMinimize = 1004, ///< decoration supports a minimize button
|
|
AbilityButtonMaximize = 1005, ///< decoration supports a maximize button
|
|
AbilityButtonClose = 1006, ///< decoration supports a close button
|
|
AbilityButtonAboveOthers = 1007, ///< decoration supports an above button
|
|
AbilityButtonBelowOthers = 1008, ///< decoration supports a below button
|
|
AbilityButtonShade = 1009, ///< decoration supports a shade button
|
|
AbilityButtonResize = 1010, ///< decoration supports a resize button
|
|
AbilityButtonApplicationMenu = 1011, ///< decoration supports the application menu button
|
|
// colors
|
|
AbilityColorTitleBack = 2000, ///< decoration supports titlebar background color, @deprecated @todo remove KDE5
|
|
ABILITYCOLOR_FIRST = AbilityColorTitleBack, ///< @internal, @deprecated @todo remove KDE5
|
|
AbilityColorTitleFore = 2001, ///< decoration supports titlebar foreground color, @deprecated @todo remove KDE5
|
|
AbilityColorTitleBlend = 2002, ///< decoration supports second titlebar background color, @deprecated @todo remove KDE5
|
|
AbilityColorFrame = 2010, ///< decoration supports frame color, @deprecated @todo remove KDE5
|
|
AbilityColorHandle = 2011, ///< decoration supports resize handle color, @deprecated @todo remove KDE5
|
|
AbilityColorButtonBack = 2020, ///< decoration supports button background color, @deprecated @todo remove KDE5
|
|
AbilityColorButtonFore = 2021, ///< decoration supports button foreground color, @deprecated @todo remove KDE5
|
|
ABILITYCOLOR_END, ///< @internal, @deprecated @todo remove KDE5
|
|
// compositing
|
|
AbilityProvidesShadow = 3000, ///< The decoration draws its own shadows.
|
|
/// @since 4.3
|
|
AbilityUsesAlphaChannel = 3001, ///< The decoration isn't clipped to the mask when compositing is enabled.
|
|
/// The mask is still used to define the input region and the blurred
|
|
/// region, when the blur plugin is enabled.
|
|
/// @since 4.3
|
|
AbilityExtendIntoClientArea = 3002, ///< The decoration respects transparentRect()
|
|
/// @since 4.4
|
|
AbilityUsesBlurBehind = 3003, ///< The decoration wants the background to be blurred, when the blur plugin is enabled.
|
|
/// @since 4.6
|
|
AbilityAnnounceAlphaChannel = 4004, ///< The decoration can tell whether it currently uses an alpha channel or not. Requires AbilityUsesAlphaChannel.
|
|
/// @since 4.10
|
|
// Tabbing
|
|
AbilityTabbing = 4000, ///< The decoration supports tabbing
|
|
// TODO colors for individual button types
|
|
ABILITY_DUMMY = 10000000,
|
|
|
|
//BEGIN ABI stability stuff
|
|
// NOTICE for ABI stability
|
|
// TODO remove with mandatory version tagging fo 4.9.x or 4.10
|
|
/** @deprecated ABI compatibility only - don't use */
|
|
AbilityClientGrouping = AbilityTabbing
|
|
//END ABI stability stuff
|
|
};
|
|
|
|
enum Requirement { REQUIREMENT_DUMMY = 1000000 };
|
|
|
|
/**
|
|
* Regions that can be returned by KDecorationUnstable::region().
|
|
*/
|
|
enum Region {
|
|
/**
|
|
* This is an invisible input region that can be used to expand the
|
|
* borders by an invisible amount, both inside and outside the
|
|
* decoration. The intended use case is to provide an active border
|
|
* area that's larger than the visible border.
|
|
*
|
|
* The mousePosition() implementation must return correct values
|
|
* for the pixels inside this region.
|
|
*
|
|
* Note that mouse events that occur within this region are not
|
|
* forwarded to the decoration. This may change in the future.
|
|
*
|
|
* @since 4.8
|
|
*/
|
|
ExtendedBorderRegion
|
|
};
|
|
|
|
/**
|
|
* Returns the mimeType used to drag and drop clientGroupItems
|
|
*/
|
|
//BEGIN ABI stability stuff
|
|
// NOTICE for ABI stability
|
|
// TODO remove with mandatory version tagging fo 4.9.x or 4.10
|
|
/** @deprecated ABI compatibility only - don't use */
|
|
static QString clientGroupItemDragMimeType() { return tabDragMimeType(); }
|
|
//END ABI stability stuff
|
|
static QString tabDragMimeType();
|
|
|
|
};
|
|
|
|
//BEGIN ABI stability stuff
|
|
// NOTICE for ABI stability
|
|
// TODO remove with mandatory version tagging fo 4.9.x or 4.10
|
|
/** @deprecated ABI compatibility only - don't use */
|
|
class KWIN_EXPORT ClientGroupItem
|
|
{
|
|
public:
|
|
ClientGroupItem(QString t, QIcon i) {
|
|
title_ = t;
|
|
icon_ = i;
|
|
}
|
|
inline QIcon icon() const {
|
|
return icon_;
|
|
}
|
|
inline QString title() const {
|
|
return title_;
|
|
}
|
|
private:
|
|
QString title_;
|
|
QIcon icon_;
|
|
};
|
|
//END ABI stability stuff
|
|
|
|
class KDecorationProvides
|
|
: public KDecorationDefines
|
|
{
|
|
public:
|
|
virtual ~KDecorationProvides() {}
|
|
virtual bool provides(Requirement req) = 0;
|
|
};
|
|
|
|
/**
|
|
* This class holds various configuration settings for the decoration.
|
|
* It is accessible from the decorations either as KDecoration::options()
|
|
* or KDecorationFactory::options().
|
|
*/
|
|
class KWIN_EXPORT KDecorationOptions : public KDecorationDefines
|
|
{
|
|
public:
|
|
KDecorationOptions();
|
|
virtual ~KDecorationOptions();
|
|
/**
|
|
* Call to update settings when the config changes. Return value is
|
|
* a combination of Setting* (SettingColors, etc.) that have changed.
|
|
* @since 4.0.1
|
|
*/
|
|
unsigned long updateSettings(KConfig* config);
|
|
/**
|
|
* Returns the color that should be used for the given part of the decoration.
|
|
* The changed flags for this setting is SettingColors.
|
|
*
|
|
* @param type The requested color type.
|
|
* @param active Whether the color should be for active or inactive windows.
|
|
*/
|
|
QColor color(ColorType type, bool active = true) const;
|
|
/**
|
|
* Returns a palette using the given decoration color as the background.
|
|
* The changed flags for this setting is SettingColors.
|
|
*
|
|
* @param type The requested color type.
|
|
* @param active Whether to return the color for active or inactive windows.
|
|
*/
|
|
QPalette palette(ColorType type, bool active = true) const;
|
|
/**
|
|
* Returns the active or inactive decoration font.
|
|
* The changed flags for this setting is SettingFont.
|
|
*
|
|
* @param active Whether to return the color for active or inactive windows.
|
|
* @param small If @a true, returns a font that's suitable for tool windows.
|
|
*/
|
|
QFont font(bool active = true, bool small = false) const;
|
|
/**
|
|
* Returns @a true if the style should use custom button positions
|
|
* The changed flags for this setting is SettingButtons.
|
|
*
|
|
* @see titleButtonsLeft
|
|
* @see titleButtonsRight
|
|
*/
|
|
bool customButtonPositions() const;
|
|
/**
|
|
* If customButtonPositions() returns true, titleButtonsLeft
|
|
* returns which buttons should be on the left side of the titlebar from left
|
|
* to right. Characters in the returned string have this meaning :
|
|
* @li 'N' application menu button
|
|
* @li 'M' window menu button
|
|
* @li 'S' on_all_desktops button
|
|
* @li 'H' quickhelp button
|
|
* @li 'I' minimize ( iconify ) button
|
|
* @li 'A' maximize button
|
|
* @li 'X' close button
|
|
* @li 'F' keep_above_others button
|
|
* @li 'B' keep_below_others button
|
|
* @li 'L' shade button
|
|
* @li 'R' resize button
|
|
* @li '_' spacer
|
|
*
|
|
* The default ( which is also returned if customButtonPositions returns false )
|
|
* is "MS".
|
|
* Unknown buttons in the returned string must be ignored.
|
|
* The changed flags for this setting is SettingButtons.
|
|
*/
|
|
QString titleButtonsLeft() const;
|
|
/**
|
|
* Returns the default left button sequence
|
|
*/
|
|
static QString defaultTitleButtonsLeft();
|
|
/**
|
|
* If customButtonPositions() returns true, titleButtonsRight
|
|
* returns which buttons should be on the right side of the titlebar from left
|
|
* to right. Characters in the return string have the same meaning like
|
|
* in titleButtonsLeft().
|
|
*
|
|
* The default ( which is also returned if customButtonPositions returns false )
|
|
* is "HIA__X".
|
|
* Unknown buttons in the returned string must be ignored.
|
|
* The changed flags for this setting is SettingButtons.
|
|
*/
|
|
QString titleButtonsRight() const;
|
|
/**
|
|
* Returns the default right button sequence.
|
|
*/
|
|
static QString defaultTitleButtonsRight();
|
|
/**
|
|
* @returns true if the style should use tooltips for window buttons
|
|
* The changed flags for this setting is SettingTooltips.
|
|
*/
|
|
bool showTooltips() const;
|
|
|
|
/**
|
|
* The preferred border size selected by the user, e.g. for accessibility
|
|
* reasons, or when using high resolution displays. It's up to the decoration
|
|
* to decide which borders or if any borders at all will obey this setting.
|
|
* It is guaranteed that the returned value will be one of those
|
|
* returned by KDecorationFactory::borderSizes(), so if that one hasn't been
|
|
* reimplemented, BorderNormal is always returned.
|
|
* The changed flags for this setting is SettingBorder.
|
|
* @param factory the decoration factory used
|
|
*/
|
|
BorderSize preferredBorderSize(KDecorationFactory* factory) const;
|
|
|
|
/*
|
|
* When this functions returns false, moving and resizing of maximized windows
|
|
* is not allowed, and therefore the decoration is allowed to turn off (some of)
|
|
* its borders.
|
|
* The changed flags for this setting is SettingButtons.
|
|
*/
|
|
bool moveResizeMaximizedWindows() const;
|
|
|
|
/**
|
|
* @internal
|
|
*/
|
|
WindowOperation operationMaxButtonClick(Qt::MouseButtons button) const;
|
|
|
|
/**
|
|
* @internal
|
|
*/
|
|
virtual unsigned long updateSettings() = 0; // returns SettingXYZ mask
|
|
|
|
protected:
|
|
/** @internal */
|
|
void setOpMaxButtonLeftClick(WindowOperation op);
|
|
/** @internal */
|
|
void setOpMaxButtonRightClick(WindowOperation op);
|
|
/** @internal */
|
|
void setOpMaxButtonMiddleClick(WindowOperation op);
|
|
/** @internal */
|
|
void setBorderSize(BorderSize bs);
|
|
/** @internal */
|
|
void setCustomButtonPositions(bool b);
|
|
/** @internal */
|
|
void setTitleButtonsLeft(const QString& b);
|
|
/** @internal */
|
|
void setTitleButtonsRight(const QString& b);
|
|
private:
|
|
/**
|
|
* @internal
|
|
*/
|
|
KDecorationOptionsPrivate* d;
|
|
};
|
|
|
|
|
|
/**
|
|
* This is the base class for a decoration object. It provides functions
|
|
* that give various information about the decorated window, and also
|
|
* provides pure virtual functions for controlling the decoration that
|
|
* every decoration should implement.
|
|
*/
|
|
class KWIN_EXPORT KDecoration
|
|
: public QObject, public KDecorationDefines
|
|
{
|
|
Q_OBJECT
|
|
public:
|
|
/**
|
|
* Constructs a KDecoration object. Both the arguments are passed from
|
|
* KDecorationFactory. Note that the initialization code of the decoration
|
|
* should be done in the init() method.
|
|
*/
|
|
KDecoration(KDecorationBridge* bridge, KDecorationFactory* factory);
|
|
/**
|
|
* Destroys the KDecoration.
|
|
*/
|
|
virtual ~KDecoration();
|
|
|
|
// requests from decoration
|
|
|
|
/**
|
|
* Returns the KDecorationOptions object, which is used to access
|
|
* configuration settings for the decoration.
|
|
*/
|
|
static const KDecorationOptions* options();
|
|
/**
|
|
* Returns @a true if the decorated window is currently active.
|
|
*/
|
|
bool isActive() const;
|
|
/**
|
|
* Returns @a true if the decoration window can be closed by the user.
|
|
*/
|
|
bool isCloseable() const;
|
|
/**
|
|
* Returns @a true if the decorated window can be maximized.
|
|
*/
|
|
bool isMaximizable() const;
|
|
/**
|
|
* Returns the current maximization mode of the decorated window.
|
|
* Note that only fully maximized windows should be treated
|
|
* as "maximized" (e.g. if the maximize button has only two states).
|
|
*/
|
|
MaximizeMode maximizeMode() const;
|
|
/**
|
|
* Returns @a true if the decorated window can be minimized by the user.
|
|
*/
|
|
bool isMinimizable() const;
|
|
/**
|
|
* Return @a true if the decorated window can show context help
|
|
* (i.e. the decoration should provide the context help button).
|
|
*/
|
|
bool providesContextHelp() const;
|
|
/**
|
|
* Returns the number of the virtual desktop the decorated window
|
|
* is currently on (including NET::OnAllDesktops for being on all
|
|
* desktops).
|
|
*/
|
|
int desktop() const;
|
|
/**
|
|
* Convenience function that returns @a true if the window is on all
|
|
* virtual desktops.
|
|
*/
|
|
bool isOnAllDesktops() const; // convenience
|
|
/**
|
|
* Returns @a true if the decoration window is modal (usually a modal dialog).
|
|
*/
|
|
bool isModal() const;
|
|
/**
|
|
* Returns @a true if the decorated window can be shaded.
|
|
*/
|
|
bool isShadeable() const;
|
|
/**
|
|
* Returns @a true if the decorated window is currently shaded.
|
|
* If the window is e.g. hover unshaded, it's not considered to be shaded.
|
|
* This function should not be used for the shade titlebar button, use
|
|
* @ref isSetShade() instead.
|
|
*
|
|
* @see isSetShade
|
|
*/
|
|
bool isShade() const;
|
|
/**
|
|
* Returns @a true if the decorated window was set to be shaded. This function
|
|
* returns also true if the window is e.g. hover unshaded, so it doesn't
|
|
* always correspond to the actual window state.
|
|
*
|
|
* @see isShade
|
|
*/
|
|
bool isSetShade() const;
|
|
/**
|
|
* Returns @a true if the decorated window should be kept above other windows.
|
|
*/
|
|
bool keepAbove() const;
|
|
/**
|
|
* Returns @a true if the decorated window should be kept below other windows.
|
|
*/
|
|
bool keepBelow() const;
|
|
/**
|
|
* Returns @a true if the decorated window can be moved by the user.
|
|
*/
|
|
bool isMovable() const;
|
|
/**
|
|
* Returns @a true if the decorated window can be resized by the user.
|
|
*/
|
|
bool isResizable() const;
|
|
/**
|
|
* This function returns the window type of the decorated window.
|
|
* The argument to this function is a mask of all window types
|
|
* the decoration knows about (as the list of valid window types
|
|
* is extended over time, and fallback types are specified in order
|
|
* to support older code). For a description of all window types,
|
|
* see the definition of the NET::WindowType type. Note that
|
|
* some window types never have decorated windows.
|
|
*
|
|
* An example of usage:
|
|
* @code
|
|
* const unsigned long supported_types = NET::NormalMask | NET::DesktopMask
|
|
* | NET::DockMask | NET::ToolbarMask | NET::MenuMask | NET::DialogMask
|
|
* | NET::OverrideMask | NET::TopMenuMask | NET::UtilityMask | NET::SplashMask;
|
|
*
|
|
* NET::WindowType type = windowType( supported_types );
|
|
*
|
|
* if ( type == NET::Utility || type == NET::Menu || type == NET::Toolbar )
|
|
* // ... use smaller decorations for tool window types
|
|
* else
|
|
* // ... use normal decorations
|
|
* @endcode
|
|
*/
|
|
NET::WindowType windowType(unsigned long supported_types) const;
|
|
/**
|
|
* Returns an icon set with the decorated window's icon.
|
|
*/
|
|
QIcon icon() const;
|
|
/**
|
|
* Returns the decorated window's caption that should be shown in the titlebar.
|
|
*/
|
|
QString caption() const;
|
|
/**
|
|
* This function invokes the window operations menu.
|
|
* \param pos specifies the place on the screen where the menu should
|
|
* show up. The menu pops up at the bottom-left corner of the specified
|
|
* rectangle, unless there is no space, in which case the menu is
|
|
* displayed above the rectangle.
|
|
*
|
|
* \note Decorations that enable a double-click operation for the menu
|
|
* button must ensure to call \a showWindowMenu() with the \a pos
|
|
* rectangle set to the menu button geometry.
|
|
* IMPORTANT: As a result of this function, the decoration object that
|
|
* called it may be destroyed after the function returns. This means
|
|
* that the decoration object must either return immediately after
|
|
* calling showWindowMenu(), or it must use
|
|
* KDecorationFactory::exists() to check it's still valid. For example,
|
|
* the code handling clicks on the menu button should look similarly
|
|
* like this:
|
|
*
|
|
* \code
|
|
* KDecorationFactory* f = factory(); // needs to be saved before
|
|
* showWindowMenu( button[MenuButton]->mapToGlobal( menuPoint ));
|
|
* if ( !f->exists( this )) // destroyed, return immediately
|
|
* return;
|
|
* button[MenuButton]->setDown(false);
|
|
* \endcode
|
|
*/
|
|
void showWindowMenu(const QRect &pos);
|
|
|
|
/**
|
|
* Overloaded version of the above.
|
|
*/
|
|
void showWindowMenu(QPoint pos);
|
|
/**
|
|
* show application menu at p
|
|
*/
|
|
void showApplicationMenu(const QPoint& p);
|
|
/**
|
|
* Returns @a true if menu available for client
|
|
*/
|
|
bool menuAvailable() const;
|
|
/**
|
|
* This function performs the given window operation. This function may destroy
|
|
* the current decoration object, just like showWindowMenu().
|
|
*/
|
|
void performWindowOperation(WindowOperation op);
|
|
/**
|
|
* If the decoration is non-rectangular, this function needs to be called
|
|
* to set the shape of the decoration.
|
|
*
|
|
* @param reg The shape of the decoration.
|
|
* @param mode The X11 values Unsorted, YSorted, YXSorted and YXBanded that specify
|
|
* the sorting of the rectangles, default value is Unsorted.
|
|
*/
|
|
void setMask(const QRegion& reg, int mode = 0);
|
|
/**
|
|
* This convenience function resets the shape mask.
|
|
*/
|
|
void clearMask(); // convenience
|
|
/**
|
|
* If this function returns @a true, the decorated window is used as a preview
|
|
* e.g. in the configuration module. In such case, the decoration can e.g.
|
|
* show some information in the window area.
|
|
*/
|
|
bool isPreview() const;
|
|
/**
|
|
* Returns the geometry of the decoration.
|
|
*/
|
|
QRect geometry() const;
|
|
/**
|
|
* Returns the icon geometry for the window, i.e. the geometry of the taskbar
|
|
* entry. This is used mainly for window minimize animations. Note that
|
|
* the geometry may be null.
|
|
*/
|
|
QRect iconGeometry() const;
|
|
/**
|
|
* Returns the intersection of the given region with the region left
|
|
* unobscured by the windows stacked above the current one. You can use
|
|
* this function to, for example, try to keep the titlebar visible if
|
|
* there is a hole available. The region returned is in the coordinate
|
|
* space of the decoration.
|
|
* @param r The region you want to check for holes
|
|
*/
|
|
QRegion unobscuredRegion(const QRegion& r) const;
|
|
/**
|
|
* Returns the handle of the window that is being decorated. It is possible
|
|
* the returned value will be 0.
|
|
* IMPORTANT: This function is meant for special purposes, and it
|
|
* usually should not be used. The main purpose is finding out additional
|
|
* information about the window's state. Also note that different kinds
|
|
* of windows are decorated: Toplevel windows managed by the window manager,
|
|
* test window in the window manager decoration module, and possibly also
|
|
* other cases.
|
|
* Careless abuse of this function will usually sooner or later lead
|
|
* to problems.
|
|
*/
|
|
WId windowId() const;
|
|
/**
|
|
* Convenience function that returns the width of the decoration.
|
|
*/
|
|
int width() const; // convenience
|
|
/**
|
|
* Convenience function that returns the height of the decoration.
|
|
*/
|
|
int height() const; // convenience
|
|
/**
|
|
* Returns the rectangle within the window frame that should be transparent.
|
|
* Usually this rectangle is the same as the client area, and it is never
|
|
* larger.
|
|
*
|
|
* If the client has requested that the window frame is extended into the
|
|
* client area, this rectangle is smaller than the client area.
|
|
*
|
|
* If the window frame should cover the whole client area, a null rectangle
|
|
* is returned.
|
|
*
|
|
* @since 4.4
|
|
*/
|
|
QRect transparentRect() const;
|
|
/**
|
|
* This function is the default handler for mouse events. All mouse events
|
|
* that are not handled by the decoration itself should be passed to it
|
|
* in order to make work operations like window resizing by dragging borders etc.
|
|
*/
|
|
void processMousePressEvent(QMouseEvent* e);
|
|
|
|
/**
|
|
* Whether the alpha channel is currently enabled. The value of this property is
|
|
* only relevant in case the decoration provides the AbilityAnnounceAlphaChannel.
|
|
*
|
|
* The compositor can make use of this information to optimize the rendering of the
|
|
* decoration.
|
|
*
|
|
* The default value of this property is @c false. That means if a decoration wants to make
|
|
* use alpha channel it has to call setAlphaEnabled with @c true.
|
|
*
|
|
* @see setAlphaEnabled
|
|
* @see alphaEnabledChanged
|
|
* @since 4.10
|
|
**/
|
|
bool isAlphaEnabled() const;
|
|
|
|
// requests to decoration
|
|
|
|
/**
|
|
* This function is called immediately after the decoration object is created.
|
|
* Due to some technical reasons, initialization should be done here
|
|
* instead of in the constructor.
|
|
*/
|
|
virtual void init() = 0; // called once right after created
|
|
|
|
/**
|
|
* This function should return mouse cursor position in the decoration.
|
|
* Positions at the edge will result in window resizing with mouse button
|
|
* pressed, center position will result in moving.
|
|
*/
|
|
virtual Position mousePosition(const QPoint& p) const = 0;
|
|
|
|
/**
|
|
* This function should return the distance from each window side to the inner
|
|
* window. The sizes may depend on the state of the decorated window, such as
|
|
* whether it's shaded. Decorations often turn off their bottom border when the
|
|
* window is shaded, and turn off their left/right/bottom borders when
|
|
* the window is maximized and moving and resizing of maximized windows is disabled.
|
|
* This function mustn't do any repaints or resizes. Also, if the sizes returned
|
|
* by this function don't match the real values, this may result in drawing errors
|
|
* or other problems.
|
|
*
|
|
* @see KDecorationOptions::moveResizeMaximizedWindows()
|
|
*/
|
|
// mustn't do any repaints, resizes or anything like that
|
|
virtual void borders(int& left, int& right, int& top, int& bottom) const = 0;
|
|
/**
|
|
* This method is called by kwin when the style should resize the decoration window.
|
|
* The usual implementation is to resize the main widget of the decoration to the
|
|
* given size.
|
|
*
|
|
* @param s Specifies the new size of the decoration window.
|
|
*/
|
|
virtual void resize(const QSize& s) = 0;
|
|
/**
|
|
* This function should return the minimum required size for the decoration.
|
|
* Note that the returned size shouldn't be too large, because it will be
|
|
* used to keep the decorated window at least as large.
|
|
*/
|
|
virtual QSize minimumSize() const = 0;
|
|
/**
|
|
* This function is called whenever the window either becomes or stops being active.
|
|
* Use isActive() to find out the current state.
|
|
*/
|
|
virtual void activeChange() = 0;
|
|
/**
|
|
* This function is called whenever the caption changes. Use caption() to get it.
|
|
*/
|
|
virtual void captionChange() = 0;
|
|
/**
|
|
* This function is called whenever the window icon changes. Use icon() to get it.
|
|
*/
|
|
virtual void iconChange() = 0;
|
|
/**
|
|
* This function is called whenever the maximalization state of the window changes.
|
|
* Use maximizeMode() to get the current state.
|
|
*/
|
|
virtual void maximizeChange() = 0;
|
|
/**
|
|
* This function is called whenever the desktop for the window changes. Use
|
|
* desktop() or isOnAllDesktops() to find out the current desktop
|
|
* on which the window is.
|
|
*/
|
|
virtual void desktopChange() = 0;
|
|
/**
|
|
* This function is called whenever the window is shaded or unshaded. Use
|
|
* isShade() to get the current state.
|
|
*/
|
|
virtual void shadeChange() = 0;
|
|
|
|
Q_SIGNALS:
|
|
/**
|
|
* This signal is emitted whenever the window's keep-above state changes.
|
|
*/
|
|
void keepAboveChanged(bool);
|
|
/**
|
|
* This signal is emitted whenever the window's keep-below state changes.
|
|
*/
|
|
void keepBelowChanged(bool);
|
|
|
|
/**
|
|
* This signal is emitted whenever application menu is closed
|
|
* Application menu button may need to be modified on this signal
|
|
*/
|
|
void menuHidden();
|
|
/**
|
|
* This signal is emitted whenever application want to show it menu
|
|
*/
|
|
void showRequest();
|
|
/**
|
|
* This signal is emitted whenever application menu becomes available
|
|
*/
|
|
void appMenuAvailable();
|
|
/**
|
|
* This signal is emitted whenever application menu becomes unavailable
|
|
*/
|
|
void appMenuUnavailable();
|
|
|
|
/**
|
|
* This signal is emitted whenever the decoration changes it's alpha enabled
|
|
* change. Only relevant in case the decoration provides AbilityAnnounceAlphaChannel.
|
|
*
|
|
* @param enabled The new state of alpha channel usage
|
|
* @see setAlphaEnabled
|
|
* @see isAlphaEnabled
|
|
* @since 4.10
|
|
**/
|
|
void alphaEnabledChanged(bool enabled);
|
|
|
|
public:
|
|
/**
|
|
* This method is not any more invoked from KWin core since version 4.8.
|
|
* There is no need to implement it.
|
|
*
|
|
* @param geom The geometry at this the bound should be drawn
|
|
* @param clear @a true if the bound should be cleared (when doing the usual XOR
|
|
* painting this argument can be simply ignored)
|
|
*
|
|
* @see geometry()
|
|
* @deprecated
|
|
*/
|
|
virtual bool drawbound(const QRect& geom, bool clear);
|
|
/**
|
|
* @internal Reserved.
|
|
*/
|
|
// TODO position will need also values for top+left+bottom etc. docking ?
|
|
virtual bool windowDocked(Position side);
|
|
/**
|
|
* This function is called to reset the decoration on settings changes.
|
|
* It is usually invoked by calling KDecorationFactory::resetDecorations().
|
|
*
|
|
* @param changed Specifies which settings were changed, given by the SettingXXX masks
|
|
*/
|
|
virtual void reset(unsigned long changed);
|
|
|
|
// special
|
|
|
|
/**
|
|
* This should be the first function called in init() to specify
|
|
* the main widget of the decoration. The widget should be created
|
|
* with parent specified by initialParentWidget() and flags
|
|
* specified by initialWFlags().
|
|
*/
|
|
void setMainWidget(QWidget*);
|
|
/**
|
|
* Convenience functions that creates and sets a main widget as necessary.
|
|
* In such case, it's usually needed to install an event filter
|
|
* on the main widget to receive important events on it.
|
|
*
|
|
* @param flags Additional widget flags for the main widget. Note that only
|
|
* flags that affect widget drawing are allowed. Window type flags
|
|
* like WX11BypassWM or WStyle_NoBorder are forbidden.
|
|
*/
|
|
void createMainWidget(Qt::WFlags flags = 0);
|
|
/**
|
|
* The parent widget that should be used for the main widget.
|
|
*/
|
|
QWidget* initialParentWidget() const;
|
|
/**
|
|
* The flags that should be used when creating the main widget.
|
|
* It is possible to add more flags when creating the main widget, but only flags
|
|
* that affect widget drawing are allowed. Window type flags like WX11BypassWM
|
|
* or WStyle_NoBorder are forbidden.
|
|
*/
|
|
Qt::WFlags initialWFlags() const;
|
|
/**
|
|
* Returns the main widget for the decoration.
|
|
*/
|
|
QWidget* widget();
|
|
/**
|
|
* Returns the main widget for the decoration.
|
|
*/
|
|
const QWidget* widget() const;
|
|
/**
|
|
* Returns the factory that created this decoration.
|
|
*/
|
|
KDecorationFactory* factory() const;
|
|
/**
|
|
* Performs X server grab. It is safe to call it several times in a row.
|
|
*/
|
|
void grabXServer();
|
|
/**
|
|
* Ungrabs X server (if the number of ungrab attempts matches the number of grab attempts).
|
|
*/
|
|
void ungrabXServer();
|
|
public Q_SLOTS:
|
|
// requests from decoration
|
|
|
|
/**
|
|
* This function can be called by the decoration to request
|
|
* closing of the decorated window. Note that closing the window
|
|
* also involves destroying the decoration.
|
|
* IMPORTANT: This function may destroy the current decoration object,
|
|
* just like showWindowMenu().
|
|
*/
|
|
void closeWindow();
|
|
/**
|
|
* Changes the maximize mode of the decorated window. This function should
|
|
* be preferred to the other maximize() overload for reacting on clicks
|
|
* on the maximize titlebar button.
|
|
*/
|
|
void maximize(Qt::MouseButtons button);
|
|
/**
|
|
* Set the maximize mode of the decorated window.
|
|
* @param mode The maximization mode to be set.
|
|
*/
|
|
void maximize(MaximizeMode mode);
|
|
/**
|
|
* Minimize the decorated window.
|
|
*/
|
|
void minimize();
|
|
/**
|
|
* Start showing context help in the window (i.e. the mouse will enter
|
|
* the what's this mode).
|
|
*/
|
|
void showContextHelp();
|
|
/**
|
|
* Moves the window to the given desktop. Use NET::OnAllDesktops for making
|
|
* the window appear on all desktops.
|
|
*/
|
|
void setDesktop(int desktop);
|
|
/**
|
|
* This function toggles the on-all-desktops state of the decorated window.
|
|
*/
|
|
void toggleOnAllDesktops(); // convenience
|
|
/**
|
|
* This function performs the operation configured as titlebar double click
|
|
* operation.
|
|
*/
|
|
void titlebarDblClickOperation();
|
|
/**
|
|
* This function performs the operation configured as titlebar wheel mouse
|
|
* operation.
|
|
* @param delta the mouse wheel delta
|
|
*/
|
|
void titlebarMouseWheelOperation(int delta);
|
|
/**
|
|
* Shades or unshades the decorated window.
|
|
* @param set Whether the window should be shaded
|
|
*/
|
|
void setShade(bool set);
|
|
/**
|
|
* Sets or reset keeping this window above others.
|
|
* @param set Whether to keep the window above others
|
|
*/
|
|
void setKeepAbove(bool set);
|
|
/**
|
|
* Sets or reset keeping this window below others.
|
|
* @param set Whether to keep the window below others
|
|
*/
|
|
void setKeepBelow(bool set);
|
|
/**
|
|
* @internal
|
|
*/
|
|
void emitKeepAboveChanged(bool above);
|
|
/**
|
|
* @internal
|
|
*/
|
|
void emitKeepBelowChanged(bool below);
|
|
|
|
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 isAlphaEnabled
|
|
* @see alphaEnabledChanged
|
|
* @since 4.10
|
|
**/
|
|
void setAlphaEnabled(bool enabled);
|
|
/**
|
|
* This slot can be reimplemented to return the regions defined
|
|
* by KDecorationDefines::Region.
|
|
*
|
|
* The default implementation always returns an empty region.
|
|
*
|
|
* @since 4.8
|
|
*/
|
|
QRegion region(KDecorationDefines::Region r);
|
|
|
|
private:
|
|
KDecorationBridge* bridge_;
|
|
QWidget* w_;
|
|
KDecorationFactory* factory_;
|
|
friend class KDecorationOptions; // for options_
|
|
friend class KDecorationUnstable; // for bridge_
|
|
static KDecorationOptions* options_;
|
|
KDecorationPrivate* d;
|
|
|
|
};
|
|
|
|
/**
|
|
* @warning THIS CLASS IS UNSTABLE!
|
|
*/
|
|
class KWIN_EXPORT KDecorationUnstable
|
|
: public KDecoration
|
|
{
|
|
Q_OBJECT
|
|
|
|
public:
|
|
KDecorationUnstable(KDecorationBridge* bridge, KDecorationFactory* factory);
|
|
virtual ~KDecorationUnstable();
|
|
/**
|
|
* This function can return additional padding values that are added outside the
|
|
* borders of the window, and can be used by the decoration if it wants to paint
|
|
* outside the frame.
|
|
*
|
|
* The typical use case is for drawing a drop shadow or glowing effect around the window.
|
|
*
|
|
* The area outside the frame cannot receive input, and when compositing is disabled,
|
|
* painting is clipped to the mask, or the window frame if no mask is defined.
|
|
*/
|
|
virtual void padding(int &left, int &right, int &top, int &bottom) const;
|
|
/**
|
|
* Returns @a true if compositing--and therefore ARGB--is enabled.
|
|
*/
|
|
bool compositingActive() const;
|
|
|
|
// Window tabbing
|
|
|
|
/**
|
|
* Returns whether or not this client group contains the active client.
|
|
*/
|
|
bool isInActiveTabGroup();
|
|
/**
|
|
* Return the amount of tabs in this group
|
|
*/
|
|
int tabCount() const;
|
|
|
|
/**
|
|
* Return the icon for the tab at index \p idx (\p idx must be smaller than tabCount())
|
|
*/
|
|
QIcon icon(int idx) const;
|
|
|
|
/**
|
|
* Return the caption for the tab at index \p idx (\p idx must be smaller than tabCount())
|
|
*/
|
|
QString caption(int idx) const;
|
|
|
|
/**
|
|
* Return the unique id for the tab at index \p idx (\p idx must be smaller than tabCount())
|
|
*/
|
|
long tabId(int idx) const;
|
|
/**
|
|
* Returns the id of the currently active client in this group.
|
|
*/
|
|
long currentTabId() const;
|
|
/**
|
|
* Activate tab for the window with the id \p id.
|
|
*/
|
|
void setCurrentTab(long id);
|
|
|
|
/**
|
|
* Entab windw with id \p A beFORE the window with the id \p B.
|
|
*/
|
|
virtual void tab_A_before_B(long A, long B);
|
|
/**
|
|
* Entab windw with id \p A beHIND the window with the id \p B.
|
|
*/
|
|
virtual void tab_A_behind_B(long A, long B);
|
|
/**
|
|
* Remove the window with the id \p id from its tabgroup and place it at \p newGeom
|
|
*/
|
|
virtual void untab(long id, const QRect& newGeom);
|
|
|
|
/**
|
|
* Close the client with the id \p id.
|
|
*/
|
|
void closeTab(long id);
|
|
/**
|
|
* Close all windows in this group.
|
|
*/
|
|
void closeTabGroup();
|
|
/**
|
|
* Display the right-click client menu belonging to the client at index \p index at the
|
|
* global coordinates specified by \p pos.
|
|
*/
|
|
void showWindowMenu(const QPoint& pos, long id);
|
|
/**
|
|
* unshadow virtuals
|
|
*/
|
|
using KDecoration::caption;
|
|
using KDecoration::icon;
|
|
using KDecoration::showWindowMenu;
|
|
/**
|
|
* Determine which action the user has mapped \p button to. Useful for determining whether
|
|
* a button press was for window tab dragging or for displaying the client menu.
|
|
*/
|
|
WindowOperation buttonToWindowOperation(Qt::MouseButtons button);
|
|
};
|
|
|
|
inline
|
|
KDecorationDefines::MaximizeMode operator^(KDecorationDefines::MaximizeMode m1, KDecorationDefines::MaximizeMode m2)
|
|
{
|
|
return KDecorationDefines::MaximizeMode(int(m1) ^ int(m2));
|
|
}
|
|
|
|
inline
|
|
KDecorationDefines::MaximizeMode operator&(KDecorationDefines::MaximizeMode m1, KDecorationDefines::MaximizeMode m2)
|
|
{
|
|
return KDecorationDefines::MaximizeMode(int(m1) & int(m2));
|
|
}
|
|
|
|
inline
|
|
KDecorationDefines::MaximizeMode operator|(KDecorationDefines::MaximizeMode m1, KDecorationDefines::MaximizeMode m2)
|
|
{
|
|
return KDecorationDefines::MaximizeMode(int(m1) | int(m2));
|
|
}
|
|
|
|
inline QWidget* KDecoration::widget()
|
|
{
|
|
return w_;
|
|
}
|
|
|
|
inline const QWidget* KDecoration::widget() const
|
|
{
|
|
return w_;
|
|
}
|
|
|
|
inline KDecorationFactory* KDecoration::factory() const
|
|
{
|
|
return factory_;
|
|
}
|
|
|
|
inline bool KDecoration::isOnAllDesktops() const
|
|
{
|
|
return desktop() == NET::OnAllDesktops;
|
|
}
|
|
|
|
inline int KDecoration::width() const
|
|
{
|
|
return geometry().width();
|
|
}
|
|
|
|
inline int KDecoration::height() const
|
|
{
|
|
return geometry().height();
|
|
}
|
|
|
|
/** @} */
|
|
|
|
#endif
|