2000-03-25 01:23:02 +03:00
|
|
|
/*****************************************************************
|
|
|
|
kwin - the KDE window manager
|
2000-06-22 22:08:35 +04:00
|
|
|
|
2000-03-25 01:23:02 +03:00
|
|
|
Copyright (C) 1999, 2000 Matthias Ettrich <ettrich@kde.org>
|
|
|
|
******************************************************************/
|
1999-08-20 03:26:42 +04:00
|
|
|
#ifndef OPTIONS_H
|
|
|
|
#define OPTIONS_H
|
|
|
|
|
1999-11-25 15:53:17 +03:00
|
|
|
#include <qobject.h>
|
1999-10-10 07:22:21 +04:00
|
|
|
#include <qfont.h>
|
1999-10-11 06:00:06 +04:00
|
|
|
#include <qpalette.h>
|
2000-10-23 22:27:23 +04:00
|
|
|
#include <qstringlist.h>
|
1999-10-11 06:00:06 +04:00
|
|
|
|
|
|
|
// increment this when you add a color type (mosfet)
|
2000-04-28 19:53:00 +04:00
|
|
|
#define KWINCOLORS 6
|
1999-08-20 03:26:42 +04:00
|
|
|
|
2001-04-20 11:19:03 +04:00
|
|
|
namespace KWinInternal {
|
|
|
|
|
|
|
|
class OptionsPrivate;
|
2001-06-13 19:47:54 +04:00
|
|
|
// NOTE: this class has to keep binary compatibility, just like other
|
|
|
|
// KWin classes accessible from the plugins
|
1999-11-25 15:53:17 +03:00
|
|
|
class Options : public QObject {
|
|
|
|
Q_OBJECT
|
1999-08-20 03:26:42 +04:00
|
|
|
public:
|
|
|
|
|
1999-11-25 15:53:17 +03:00
|
|
|
Options();
|
|
|
|
~Options();
|
1999-11-25 19:05:27 +03:00
|
|
|
|
|
|
|
|
1999-08-20 03:26:42 +04:00
|
|
|
/*!
|
|
|
|
Different focus policies:
|
|
|
|
<ul>
|
1999-09-27 20:02:44 +04:00
|
|
|
|
1999-08-20 03:26:42 +04:00
|
|
|
<li>ClickToFocus - Clicking into a window activates it. This is
|
|
|
|
also the default.
|
1999-09-27 20:02:44 +04:00
|
|
|
|
1999-08-20 03:26:42 +04:00
|
|
|
<li>FocusFollowsMouse - Moving the mouse pointer actively onto a
|
2000-06-22 22:08:35 +04:00
|
|
|
normal window activates it. For convenience, the desktop and
|
|
|
|
windows on the dock are excluded. They require clicking.
|
1999-09-27 20:02:44 +04:00
|
|
|
|
1999-08-20 03:26:42 +04:00
|
|
|
<li>FocusUnderMouse - The window that happens to be under the
|
2000-06-22 22:08:35 +04:00
|
|
|
mouse pointer becomes active. The invariant is: no window can
|
|
|
|
have focus that is not under the mouse. This also means that
|
|
|
|
Alt-Tab won't work properly and popup dialogs are usually
|
|
|
|
unsable with the keyboard. Note that the desktop and windows on
|
|
|
|
the dock are excluded for convenience. They get focus only when
|
|
|
|
clicking on it.
|
|
|
|
|
|
|
|
<li>FocusStrictlyUnderMouse - this is even worse than
|
|
|
|
FocusUnderMouse. Only the window under the mouse pointer is
|
|
|
|
active. If the mouse points nowhere, nothing has the focus. If
|
|
|
|
the mouse points onto the desktop, the desktop has focus. The
|
|
|
|
same holds for windows on the dock.
|
1999-09-27 20:02:44 +04:00
|
|
|
|
1999-12-22 07:49:43 +03:00
|
|
|
Note that FocusUnderMouse and FocusStrictlyUnderMouse are not
|
1999-08-20 03:26:42 +04:00
|
|
|
particulary useful. They are only provided for old-fashined
|
|
|
|
die-hard UNIX people ;-)
|
1999-09-27 20:02:44 +04:00
|
|
|
|
1999-08-20 03:26:42 +04:00
|
|
|
</ul>
|
|
|
|
*/
|
1999-12-22 07:49:43 +03:00
|
|
|
enum FocusPolicy { ClickToFocus, FocusFollowsMouse, FocusUnderMouse, FocusStrictlyUnderMouse };
|
1999-08-20 03:26:42 +04:00
|
|
|
FocusPolicy focusPolicy;
|
1999-11-25 15:53:17 +03:00
|
|
|
|
2000-06-28 17:20:42 +04:00
|
|
|
|
2000-07-10 00:29:53 +04:00
|
|
|
/**
|
|
|
|
Whether clicking on a window raises it in FocusFollowsMouse
|
|
|
|
mode or not.
|
|
|
|
*/
|
|
|
|
bool clickRaise;
|
|
|
|
|
|
|
|
/**
|
|
|
|
whether autoraise is enabled FocusFollowsMouse mode or not.
|
|
|
|
*/
|
|
|
|
bool autoRaise;
|
2000-07-12 16:46:58 +04:00
|
|
|
|
2000-07-10 00:29:53 +04:00
|
|
|
/**
|
|
|
|
autoraise interval
|
|
|
|
*/
|
|
|
|
int autoRaiseInterval;
|
|
|
|
|
2001-01-14 23:16:04 +03:00
|
|
|
/**
|
|
|
|
Whether shade hover is enabled or not
|
|
|
|
*/
|
|
|
|
bool shadeHover;
|
|
|
|
|
|
|
|
/**
|
|
|
|
shade hover interval
|
|
|
|
*/
|
|
|
|
int shadeHoverInterval;
|
|
|
|
|
1999-10-10 07:22:21 +04:00
|
|
|
/**
|
2000-06-22 22:08:35 +04:00
|
|
|
Different Alt-Tab-Styles:
|
|
|
|
<ul>
|
2000-06-28 17:20:42 +04:00
|
|
|
|
2000-06-22 22:08:35 +04:00
|
|
|
<li> KDE - the recommended KDE style. Alt-Tab opens a nice icon
|
|
|
|
box that makes it easy to select the window you want to tab
|
|
|
|
to. The order automatically adjusts to the most recently used
|
|
|
|
windows. Note that KDE style does not work with the
|
|
|
|
FocusUnderMouse and FocusStrictlyUnderMouse focus
|
|
|
|
policies. Choose ClickToFocus or FocusFollowsMouse instead.
|
2000-06-28 17:20:42 +04:00
|
|
|
|
2000-06-22 22:08:35 +04:00
|
|
|
<li> CDE - the old-fashion CDE style. Alt-Tab cycles between
|
|
|
|
the windows in static order. The current window gets raised,
|
|
|
|
the previous window gets lowered.
|
2000-06-28 17:20:42 +04:00
|
|
|
|
2000-06-22 22:08:35 +04:00
|
|
|
</ul>
|
1999-10-10 07:22:21 +04:00
|
|
|
*/
|
2000-06-22 22:08:35 +04:00
|
|
|
enum AltTabStyle { KDE, CDE };
|
|
|
|
AltTabStyle altTabStyle;
|
2000-06-28 17:20:42 +04:00
|
|
|
|
2001-06-03 13:04:03 +04:00
|
|
|
/**
|
|
|
|
* Xinerama options
|
|
|
|
*/
|
|
|
|
bool xineramaEnabled;
|
|
|
|
bool xineramaPlacementEnabled;
|
|
|
|
bool xineramaMovementEnabled;
|
|
|
|
bool xineramaMaximizeEnabled;
|
2000-06-28 17:20:42 +04:00
|
|
|
|
2001-01-12 02:41:07 +03:00
|
|
|
/**
|
|
|
|
Number of desktop rowsd
|
2001-01-14 23:16:04 +03:00
|
|
|
*/
|
2001-01-12 02:41:07 +03:00
|
|
|
int desktopRows;
|
2000-10-26 13:38:09 +04:00
|
|
|
|
|
|
|
|
2000-06-22 22:08:35 +04:00
|
|
|
/**
|
|
|
|
MoveResizeMode, either Tranparent or Opaque.
|
|
|
|
*/
|
|
|
|
enum MoveResizeMode { Transparent, Opaque };
|
1999-10-10 07:22:21 +04:00
|
|
|
|
1999-09-27 20:02:44 +04:00
|
|
|
MoveResizeMode resizeMode;
|
|
|
|
MoveResizeMode moveMode;
|
1999-08-20 03:26:42 +04:00
|
|
|
|
2000-08-22 14:35:22 +04:00
|
|
|
/**
|
|
|
|
* Can maximized windows be moved or resized
|
|
|
|
*/
|
|
|
|
bool moveResizeMaximizedWindows;
|
|
|
|
|
1999-11-16 11:53:02 +03:00
|
|
|
/**
|
|
|
|
* Placement policies. How workspace decides the way windows get positioned
|
|
|
|
* on the screen. The better the policy, the heavier the resource use.
|
|
|
|
* Normally you don't have to worry. What the WM adds to the startup time
|
|
|
|
* is nil compared to the creation of the window itself in the memory
|
|
|
|
*/
|
1999-11-20 09:27:07 +03:00
|
|
|
enum PlacementPolicy { Random, Smart, Cascade };
|
1999-11-16 11:53:02 +03:00
|
|
|
PlacementPolicy placement;
|
|
|
|
|
1999-08-20 03:26:42 +04:00
|
|
|
bool focusPolicyIsReasonable() {
|
1999-10-10 07:22:21 +04:00
|
|
|
return focusPolicy == ClickToFocus || focusPolicy == FocusFollowsMouse;
|
1999-08-20 03:26:42 +04:00
|
|
|
}
|
|
|
|
|
2000-06-22 22:08:35 +04:00
|
|
|
/**
|
|
|
|
* Basic color types that should be recognized by all decoration styles.
|
|
|
|
* Not all styles have to implement all the colors, but for the ones that
|
|
|
|
* are implemented you should retrieve them here.
|
|
|
|
*/
|
|
|
|
// increment KWINCOLORS if you add something (mosfet)
|
|
|
|
enum ColorType{TitleBar=0, TitleBlend, Font, ButtonBg, Frame, Handle};
|
|
|
|
|
1999-10-10 07:22:21 +04:00
|
|
|
/**
|
|
|
|
* Return the color for the given decoration.
|
|
|
|
*/
|
|
|
|
const QColor& color(ColorType type, bool active=true);
|
1999-10-11 06:00:06 +04:00
|
|
|
/**
|
|
|
|
* Return a colorgroup using the given decoration color as the background
|
|
|
|
*/
|
|
|
|
const QColorGroup& colorGroup(ColorType type, bool active=true);
|
1999-10-10 07:22:21 +04:00
|
|
|
/**
|
|
|
|
* Return the active or inactive decoration font.
|
|
|
|
*/
|
2000-07-12 16:46:58 +04:00
|
|
|
const QFont& font(bool active=true, bool small = false);
|
2000-07-10 00:29:53 +04:00
|
|
|
|
1999-11-20 09:27:07 +03:00
|
|
|
/**
|
2000-07-10 00:29:53 +04:00
|
|
|
* whether we animate the shading of windows to titlebar or not
|
1999-11-20 09:27:07 +03:00
|
|
|
*/
|
2000-07-10 00:29:53 +04:00
|
|
|
bool animateShade;
|
|
|
|
|
1999-11-26 02:12:32 +03:00
|
|
|
/**
|
2000-07-10 00:29:53 +04:00
|
|
|
* the size of the zone that triggers snapping on desktop borders
|
1999-11-26 02:12:32 +03:00
|
|
|
*/
|
2000-07-10 00:29:53 +04:00
|
|
|
int borderSnapZone;
|
|
|
|
|
1999-11-26 02:12:32 +03:00
|
|
|
/**
|
2000-07-10 00:29:53 +04:00
|
|
|
* the number of animation steps (would this be general?)
|
1999-11-26 02:12:32 +03:00
|
|
|
*/
|
2000-07-10 00:29:53 +04:00
|
|
|
int windowSnapZone;
|
2000-10-26 13:38:09 +04:00
|
|
|
|
|
|
|
|
2000-11-02 11:33:00 +03:00
|
|
|
/**
|
2000-11-02 21:15:39 +03:00
|
|
|
* snap only when windows will overlap
|
2000-11-02 11:33:00 +03:00
|
|
|
*/
|
2000-11-02 21:15:39 +03:00
|
|
|
bool snapOnlyWhenOverlapping;
|
2000-11-02 11:33:00 +03:00
|
|
|
|
2000-09-25 19:30:51 +04:00
|
|
|
/**
|
|
|
|
* whether we animate the minimization of windows or not
|
|
|
|
*/
|
|
|
|
bool animateMinimize;
|
2000-10-26 13:38:09 +04:00
|
|
|
|
2000-09-25 19:30:51 +04:00
|
|
|
/**
|
|
|
|
* Animation speed (0 .. 10 )
|
|
|
|
*/
|
|
|
|
int animateMinimizeSpeed;
|
2000-03-25 01:23:02 +03:00
|
|
|
|
|
|
|
|
2000-10-23 22:27:23 +04:00
|
|
|
/**
|
|
|
|
* List of window classes to ignore PPosition size hint
|
|
|
|
*/
|
|
|
|
QStringList ignorePositionClasses;
|
|
|
|
|
1999-11-29 05:06:41 +03:00
|
|
|
// mouse bindings
|
2000-03-25 01:23:02 +03:00
|
|
|
|
1999-11-29 05:06:41 +03:00
|
|
|
enum WindowOperation{
|
|
|
|
MaximizeOp = 5000,
|
|
|
|
RestoreOp,
|
|
|
|
IconifyOp,
|
|
|
|
MoveOp,
|
|
|
|
ResizeOp,
|
|
|
|
CloseOp,
|
|
|
|
StickyOp,
|
|
|
|
ShadeOp,
|
2000-06-28 17:20:42 +04:00
|
|
|
StaysOnTopOp,
|
1999-11-29 05:06:41 +03:00
|
|
|
OperationsOp,
|
2001-01-14 23:16:04 +03:00
|
|
|
ToggleStoreSettingsOp,
|
2001-02-27 10:19:52 +03:00
|
|
|
HMaximizeOp,
|
|
|
|
VMaximizeOp,
|
|
|
|
LowerOp,
|
1999-11-29 05:06:41 +03:00
|
|
|
NoOp
|
|
|
|
};
|
|
|
|
|
|
|
|
WindowOperation operationTitlebarDblClick() { return OpTitlebarDblClick; }
|
2000-03-25 01:23:02 +03:00
|
|
|
|
1999-11-29 05:06:41 +03:00
|
|
|
enum MouseCommand {
|
|
|
|
MouseRaise, MouseLower, MouseOperationsMenu, MouseToggleRaiseAndLower,
|
|
|
|
MouseActivateAndRaise, MouseActivateAndLower, MouseActivate,
|
|
|
|
MouseActivateRaiseAndPassClick, MouseActivateAndPassClick,
|
2001-06-07 22:17:24 +04:00
|
|
|
MouseMove, MouseResize,
|
2001-04-02 12:31:58 +04:00
|
|
|
MouseShade,
|
|
|
|
MouseNothing
|
1999-11-29 05:06:41 +03:00
|
|
|
};
|
|
|
|
|
2000-03-25 01:23:02 +03:00
|
|
|
MouseCommand commandActiveTitlebar1() { return CmdActiveTitlebar1; }
|
1999-11-29 05:06:41 +03:00
|
|
|
MouseCommand commandActiveTitlebar2() { return CmdActiveTitlebar2; }
|
|
|
|
MouseCommand commandActiveTitlebar3() { return CmdActiveTitlebar3; }
|
|
|
|
MouseCommand commandInactiveTitlebar1() { return CmdInactiveTitlebar1; }
|
|
|
|
MouseCommand commandInactiveTitlebar2() { return CmdInactiveTitlebar2; }
|
|
|
|
MouseCommand commandInactiveTitlebar3() { return CmdInactiveTitlebar3; }
|
|
|
|
MouseCommand commandWindow1() { return CmdWindow1; }
|
|
|
|
MouseCommand commandWindow2() { return CmdWindow2; }
|
|
|
|
MouseCommand commandWindow3() { return CmdWindow3; }
|
|
|
|
MouseCommand commandAll1() { return CmdAll1; }
|
|
|
|
MouseCommand commandAll2() { return CmdAll2; }
|
|
|
|
MouseCommand commandAll3() { return CmdAll3; }
|
2001-06-07 22:17:24 +04:00
|
|
|
uint keyCmdAllModKey() { return CmdAllModKey; }
|
1999-11-29 05:06:41 +03:00
|
|
|
|
2000-03-25 01:23:02 +03:00
|
|
|
|
1999-11-29 05:06:41 +03:00
|
|
|
static WindowOperation windowOperation(const QString &name );
|
|
|
|
static MouseCommand mouseCommand(const QString &name);
|
2001-05-03 12:06:28 +04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @returns true if the style should use custom button positions
|
|
|
|
* @see #titleButtonsLeft
|
|
|
|
* @see #titleButtonsRight
|
|
|
|
*/
|
|
|
|
bool customButtonPositions();
|
|
|
|
/**
|
|
|
|
* If @ref 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 'M' menu button
|
|
|
|
* @li 'S' sticky button
|
|
|
|
* @li 'H' quickhelp button
|
|
|
|
* @li 'I' iconify ( minimize ) button
|
|
|
|
* @li 'A' maximize button
|
|
|
|
* @li 'X' close button
|
|
|
|
* @li '_' spacer
|
|
|
|
*
|
|
|
|
* The default ( which is also returned if customButtonPositions returns false )
|
|
|
|
* is "MS".
|
|
|
|
*/
|
|
|
|
QString titleButtonsLeft();
|
|
|
|
/**
|
|
|
|
* If @ref 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 @ref titleButtonsLeft .
|
|
|
|
*
|
|
|
|
* The default ( which is also returned if customButtonPositions returns false )
|
|
|
|
* is "HIAX".
|
|
|
|
*/
|
|
|
|
QString titleButtonsRight();
|
1999-11-29 05:06:41 +03:00
|
|
|
|
2001-07-01 14:10:17 +04:00
|
|
|
/**
|
|
|
|
* @returns true if the style should use tooltips for window buttons
|
|
|
|
*/
|
2001-07-02 16:40:14 +04:00
|
|
|
bool showTooltips();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @returns true if window button tooltips should use a fade-in effect
|
|
|
|
* @see #animateTooltips
|
|
|
|
* @see #showTooltips
|
|
|
|
*/
|
|
|
|
bool fadeTooltips();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @returns true if window button tooltips should use an animated effect.
|
|
|
|
* When this is true, tooltips should use a animated scroll effect. If
|
|
|
|
* fadeToolTips is also true, tooltips should be faded-in instead.
|
|
|
|
* @see #fadeTooltips
|
|
|
|
* @see #showTooltips
|
|
|
|
*/
|
|
|
|
bool animateTooltips();
|
|
|
|
|
2001-08-27 09:42:32 +04:00
|
|
|
/**
|
|
|
|
* @returns true if electric borders are enabled. With electric borders
|
|
|
|
* you can change desktop by moving the mouse pointer towards the edge
|
|
|
|
* of the screen
|
|
|
|
*/
|
|
|
|
bool electricBorders();
|
1999-11-25 15:53:17 +03:00
|
|
|
|
2001-09-06 23:44:06 +04:00
|
|
|
/**
|
|
|
|
* @returns the activation delay for electric borders in milliseconds.
|
|
|
|
*/
|
|
|
|
int electricBorderDelay();
|
|
|
|
|
1999-11-25 15:53:17 +03:00
|
|
|
public slots:
|
1999-10-10 07:22:21 +04:00
|
|
|
void reload();
|
1999-11-25 19:05:27 +03:00
|
|
|
|
2000-01-24 02:33:29 +03:00
|
|
|
signals:
|
2001-04-22 09:39:17 +04:00
|
|
|
void resetPlugin();
|
2000-01-24 02:33:29 +03:00
|
|
|
void resetClients();
|
2000-03-25 01:23:02 +03:00
|
|
|
|
1999-10-10 07:22:21 +04:00
|
|
|
protected:
|
2000-07-12 16:46:58 +04:00
|
|
|
QFont activeFont, inactiveFont, activeFontSmall, inactiveFontSmall;
|
1999-11-20 09:27:07 +03:00
|
|
|
|
|
|
|
private:
|
2000-07-10 00:29:53 +04:00
|
|
|
|
1999-11-29 05:06:41 +03:00
|
|
|
|
2000-03-25 01:23:02 +03:00
|
|
|
|
1999-11-29 05:06:41 +03:00
|
|
|
WindowOperation OpTitlebarDblClick;
|
|
|
|
|
|
|
|
// mouse bindings
|
|
|
|
MouseCommand CmdActiveTitlebar1;
|
|
|
|
MouseCommand CmdActiveTitlebar2;
|
|
|
|
MouseCommand CmdActiveTitlebar3;
|
|
|
|
MouseCommand CmdInactiveTitlebar1;
|
|
|
|
MouseCommand CmdInactiveTitlebar2;
|
|
|
|
MouseCommand CmdInactiveTitlebar3;
|
|
|
|
MouseCommand CmdWindow1;
|
|
|
|
MouseCommand CmdWindow2;
|
|
|
|
MouseCommand CmdWindow3;
|
|
|
|
MouseCommand CmdAll1;
|
|
|
|
MouseCommand CmdAll2;
|
|
|
|
MouseCommand CmdAll3;
|
2001-06-07 22:17:24 +04:00
|
|
|
uint CmdAllModKey;
|
|
|
|
|
2001-04-20 11:19:03 +04:00
|
|
|
OptionsPrivate* d;
|
1999-08-20 03:26:42 +04:00
|
|
|
};
|
|
|
|
|
|
|
|
extern Options* options;
|
|
|
|
|
2001-04-20 11:19:03 +04:00
|
|
|
}; // namespace
|
|
|
|
|
1999-08-20 03:26:42 +04:00
|
|
|
#endif
|