5c0d0e8e8e
The @param doxygen tag is formatted way nicer and should be used throughout our apidox. REVIEW: 101596
170 lines
6.0 KiB
C++
170 lines
6.0 KiB
C++
/*
|
|
* Copyright 2009 Marco Martin <notmart@gmail.com>
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU Library General Public License as
|
|
* published by the Free Software Foundation; either version 2, 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 Library General Public
|
|
* License along with this program; if not, write to the
|
|
* Free Software Foundation, Inc.,
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
*/
|
|
|
|
#ifndef PLASMA_WINDOWEFFECTS_H
|
|
#define PLASMA_WINDOWEFFECTS_H
|
|
|
|
#include <QtGui/QWidget>
|
|
|
|
#include <plasma/plasma.h>
|
|
|
|
/** @headerfile plasma/windoweffect.h <Plasma/WindowEffect> */
|
|
|
|
namespace Plasma
|
|
{
|
|
|
|
/**
|
|
* Namespace for all window effects for Plasma/KWin interaction
|
|
* @since 4.4
|
|
*/
|
|
namespace WindowEffects
|
|
{
|
|
enum Effect {
|
|
Slide = 1,
|
|
WindowPreview = 2,
|
|
PresentWindows = 3,
|
|
PresentWindowsGroup = 4,
|
|
HighlightWindows = 5,
|
|
OverrideShadow = 6,
|
|
BlurBehind = 7,
|
|
Dashboard = 8
|
|
};
|
|
|
|
/**
|
|
* @return if an atom property is available
|
|
*
|
|
* @param effect the effect we want to check
|
|
* @since 4.4
|
|
*/
|
|
PLASMA_EXPORT bool isEffectAvailable(Effect effect);
|
|
|
|
/**
|
|
* Mark a window as sliding from screen edge
|
|
*
|
|
* @param id of the window on which we want to apply the effect
|
|
* @param location edge of the screen from which we want the sliding effect.
|
|
* Desktop and Floating won't have effect.
|
|
* @param offset distance in pixels from the screen edge defined by location
|
|
* @since 4.4
|
|
*/
|
|
PLASMA_EXPORT void slideWindow(WId id, Plasma::Location location, int offset);
|
|
|
|
/**
|
|
* Mark a window as sliding from screen edge
|
|
* This is an overloaded member function provided for convenience
|
|
*
|
|
* @param widget QWidget corresponding to the top level window we want to animate
|
|
* @param location edge of the screen from which we want the sliding effect.
|
|
* Desktop and Floating won't have effect.
|
|
* @since 4.4
|
|
*/
|
|
PLASMA_EXPORT void slideWindow(QWidget *widget, Plasma::Location location);
|
|
|
|
/**
|
|
* @return dimension of all the windows passed as parameter
|
|
*
|
|
* @param ids all the windows we want the size
|
|
* @since 4.4
|
|
*/
|
|
PLASMA_EXPORT QList<QSize> windowSizes(const QList<WId> &ids);
|
|
|
|
/**
|
|
* Paint inside the window parent the thumbnails of the windows list in
|
|
* the respective rectangles of the rects list
|
|
*
|
|
* @param parent window where we should paint
|
|
* @param windows windows we want a thumbnail of.
|
|
* If it is empty any thumbnail will be deleted
|
|
* @param rects rectangles in parent coordinates where to paint the window thumbnails.
|
|
* If it is empty any thumbnail will be deleted
|
|
* @since 4.4
|
|
*/
|
|
PLASMA_EXPORT void showWindowThumbnails(WId parent, const QList<WId> &windows = QList<WId>(), const QList<QRect> &rects = QList<QRect>());
|
|
|
|
/**
|
|
* Activate the Present Windows effect for the given groups of windows.
|
|
*
|
|
* @param controller The window which is the controller of this effect. The property
|
|
* will be set on this window. It will be removed by the effect
|
|
* @param ids all the windows which should be presented.
|
|
* @since 4.4
|
|
*/
|
|
PLASMA_EXPORT void presentWindows(WId controller, const QList<WId> &ids);
|
|
|
|
/**
|
|
* Activate the Present Windows effect for the windows of the given desktop.
|
|
*
|
|
* @param controller The window which is the controller of this effect. The property
|
|
* will be set on this window. It will be removed by the effect
|
|
* @param desktop The desktop whose windows should be presented. -1 for all desktops
|
|
* @since 4.4
|
|
*/
|
|
PLASMA_EXPORT void presentWindows(WId controller, int desktop = -1);
|
|
|
|
/**
|
|
* Highlight the selected windows, making all the others translucent
|
|
*
|
|
* @param controller The window which is the controller of this effect. The property
|
|
* will be set on this window. It will be removed by the effect
|
|
* @param ids all the windows which should be highlighted.
|
|
* @since 4.4
|
|
*/
|
|
PLASMA_EXPORT void highlightWindows(WId controller, const QList<WId> &ids);
|
|
|
|
/**
|
|
* Forbid te windowmanager to automatically generate a shadow for this window
|
|
* @param window the window that won't have shadow
|
|
* @param override true if it won't have shadow, false enables it again
|
|
*
|
|
* @since 4.4
|
|
*/
|
|
PLASMA_EXPORT void overrideShadow(WId window, bool override);
|
|
|
|
/**
|
|
* Instructs the window manager to blur the background in the specified region
|
|
* behind the given window. Passing a null region will enable the blur effect
|
|
* for the whole window. The region is relative to the top-left corner of the
|
|
* client area.
|
|
*
|
|
* Note that you will usually want to set the region to the shape of the window,
|
|
* excluding any shadow or halo.
|
|
*
|
|
* @param window The window for which to enable the blur effect
|
|
* @param enable Enable the effect if @a true, disable it if @false
|
|
* @param region The region within the window where the background will be blurred
|
|
* @since 4.5
|
|
*/
|
|
PLASMA_EXPORT void enableBlurBehind(WId window, bool enable = true, const QRegion ®ion = QRegion());
|
|
|
|
/**
|
|
* Instructs the window manager to handle the given window as dashboard window as
|
|
* Dashboard windows should be handled diffrently and may have special effects
|
|
* applied to them.
|
|
*
|
|
* @param window The window for which to enable the blur effect
|
|
* @since 4.6
|
|
*/
|
|
PLASMA_EXPORT void markAsDashboard(WId window);
|
|
}
|
|
|
|
} // namespace Plasma
|
|
|
|
#endif
|
|
|