My KWIN fork where I work on features like per-output virtual desktops
Find a file
Martin Flöser 9993c6d674 Add a dbus method getWindowInfo returning same data as queryWindowInfo
Summary:
This dbus method is intended to be used by the kwin rules dialog. KWin
can pass the internal id to the rules dialog through a command line
argument (or similar way) and the dialog can query the information
through the dbus call for the provided id. Thus it's possible to
implement one way to query the information which works on both X11 and
Wayland without any windowing system specific functionality.

Test Plan: See new added integration test

Reviewers: #kwin

Subscribers: kwin

Tags: #kwin

Differential Revision: https://phabricator.kde.org/D17433
2018-12-17 18:12:17 +01:00
autotests Add a dbus method getWindowInfo returning same data as queryWindowInfo 2018-12-17 18:12:17 +01:00
cmake/modules Remove unused FindQt5PlatformSupport.cmake 2018-11-04 17:01:49 +01:00
colorcorrection [colorcorrection] Make GammaRamp non-copyable 2018-10-07 20:57:57 +03:00
data Make it easier to debug the virtualkeyboard 2018-12-10 16:28:13 +05:30
decorations [decorations] Emit DecorationSettings::fontChanged signal 2018-11-15 22:08:41 +02:00
doc [KCMs] move GHNS buttons to the normal location 2018-10-31 07:29:22 -06:00
effects [autotests] Test window open/close animations 2018-12-14 21:11:42 +02:00
helpers Merge branch 'Plasma/5.14' 2018-11-16 13:48:46 +01:00
kcmkwin [kcmkwin/compositing] Remove effect list item selection, fix list item size after hiding the effect video, use a real button as the play button and use the right busy indicator 2018-12-11 08:01:46 -07:00
kconf_update [kconf_update] Use scripted dim screen effect 2018-11-26 16:18:46 +02:00
libinput Fix dbus export of property Device::supportedButtons 2018-12-13 19:36:28 +01:00
libkwineffects [libkwineffects] Don't mark a painted window as transformed twice 2018-12-14 21:10:33 +02:00
packageplugins Use override 2018-12-03 18:26:56 +05:30
platformsupport Request a high-priority EGL contexts 2018-03-29 20:34:22 +09:00
plugins Build platform plugins in correct sub directory of build dir 2018-12-13 19:36:28 +01:00
qml fix virtual keyboard on Plasma Mobile 2018-12-10 16:50:06 +01:00
scripting [scripting] Introduce complete function 2018-11-17 13:44:20 +02:00
scripts SVN_SILENT made messages (.desktop file) - always resolve ours 2018-11-22 06:02:11 +01:00
shaders [libkwinglutils] Cleanup Shader API: removal of ShaderType 2016-01-26 09:42:49 +01:00
tabbox SVN_SILENT made messages (.desktop file) - always resolve ours 2018-11-22 06:02:11 +01:00
tests Use locked cursor position hint 2018-07-27 17:19:33 +02:00
.arcconfig Adding .arcconfig 2016-03-15 13:37:47 +01:00
.arclint Add .arclint 2018-10-02 19:44:07 +03:00
16-apps-kwin.png Fix installing of icons 2014-06-02 14:56:42 +02:00
32-apps-kwin.png Fix installing of icons 2014-06-02 14:56:42 +02:00
48-apps-kwin.png Fix installing of icons 2014-06-02 14:56:42 +02:00
abstract_client.cpp [wayland] add enter/leave virtual desktop API 2018-11-14 11:08:46 +00:00
abstract_client.h [wayland] Send only clients that were on the removed desktop to a new desktop 2018-12-14 14:22:30 +02:00
abstract_opengl_context_attribute_builder.cpp Request a high-priority EGL contexts 2018-03-29 20:34:22 +09:00
abstract_opengl_context_attribute_builder.h Request a high-priority EGL contexts 2018-03-29 20:34:22 +09:00
abstract_output.cpp Add output orientation size helper 2018-11-14 20:05:39 +01:00
abstract_output.h Add output orientation size helper 2018-11-14 20:05:39 +01:00
activation.cpp Drop no longer needed cast to Client in TabGroup related code 2018-05-20 20:18:09 +02:00
activities.cpp Revert "Remove saving and loading (and client matching by) WM_COMMAND." 2016-06-23 21:07:03 +02:00
activities.h [autotests/integration] Add a first test case for activities 2016-08-12 12:52:47 +02:00
appmenu.cpp Don't try to open application menu when client doesn't have one 2018-04-23 15:42:02 +02:00
appmenu.h Fix minor EBN issues 2018-08-29 21:02:16 +03:00
atoms.cpp Restore global menu support 2017-01-11 10:21:03 +01:00
atoms.h Restore global menu support 2017-01-11 10:21:03 +01:00
client.cpp Support starting the killer_helper from build dir 2018-11-09 09:24:50 +01:00
client.h Define ShellClient debug output 2018-09-17 04:11:03 +02:00
client_machine.cpp Fix heap-use-after-free use in resolving ClientMachine 2015-10-01 10:09:52 +02:00
client_machine.h
CMakeLists.txt Hide mouse cursor when interacting with touch screen 2018-12-13 18:55:46 +01:00
composite.cpp Make sure that effect windows outlive effects 2018-12-02 19:59:53 +02:00
composite.h Drop the explicit fallback to XRender 2017-10-19 18:26:57 +02:00
config-kwin.h.cmake Require libinput and udev 2018-02-04 15:00:42 +01:00
CONFIGURING
COPYING Put licence files on each repo, removing from root. 2014-03-26 19:01:09 +01:00
COPYING.DOC Put licence files on each repo, removing from root. 2014-03-26 19:01:09 +01:00
cursor.cpp Set specific edge cursor shape when resizing 2018-06-11 10:05:07 +01:00
cursor.h Set specific edge cursor shape when resizing 2018-06-11 10:05:07 +01:00
dbusinterface.cpp Add a dbus method getWindowInfo returning same data as queryWindowInfo 2018-12-17 18:12:17 +01:00
dbusinterface.h Add a dbus method getWindowInfo returning same data as queryWindowInfo 2018-12-17 18:12:17 +01:00
debug_console.cpp i18n: Fix untranslatable table row "Delta" 2018-09-17 13:43:05 +03:00
debug_console.h Require libinput and udev 2018-02-04 15:00:42 +01:00
debug_console.ui fixuifiles 2018-09-18 07:52:44 +02:00
deleted.cpp [libkwineffects] Replace property name lookup with calling the virtual methods 2018-11-30 11:22:20 +00:00
deleted.h [libkwineffects] Replace property name lookup with calling the virtual methods 2018-11-30 11:22:20 +00:00
effectloader.cpp Introduce an EffectsHandler::animationsSupported -> bool 2016-08-15 17:38:33 +02:00
effectloader.h Fix minor EBN issues in the Doxygen code 2018-12-03 23:40:12 +02:00
effects.cpp [effects] Don't use dynamic_cast 2018-12-14 21:04:40 +02:00
effects.h Make sure that effect windows outlive effects 2018-12-02 19:59:53 +02:00
egl_context_attribute_builder.cpp Request a high-priority EGL contexts 2018-03-29 20:34:22 +09:00
egl_context_attribute_builder.h [qpa] Use the new OpenGLContextAttributeBuilder to create Qt's OpenGL context 2017-07-17 16:53:37 +02:00
events.cpp Create a dedicated X11Filter for Client sync events and move it to X11 platform 2017-10-19 19:56:58 +02:00
ExtraDesktop.sh
fixqopengl.h Fix the build on armhf/aarch64 2018-03-06 09:25:33 +05:30
focuschain.cpp Use explicit Chain type in the focus chain 2018-07-30 11:23:43 +03:00
focuschain.h Use explicit Chain type in the focus chain 2018-07-30 11:23:43 +03:00
geometry.cpp Fix minor EBN issues 2018-08-29 21:02:16 +03:00
geometrytip.cpp Port to CMake AUTOMOC 2016-02-01 21:05:36 +01:00
geometrytip.h Use Xcb::GeometryHints instead of XGetWMNormalHints 2015-01-27 12:48:03 +01:00
gestures.cpp Fix build with clang and GCC6 2017-03-29 14:45:44 +02:00
gestures.h Add support for screenedge touchscreen events through XInput 2.2 2017-03-27 17:44:15 +02:00
globalshortcuts.cpp Don't try to filter null key combinations 2018-04-24 16:35:23 +02:00
globalshortcuts.h Fix minor EBN issues in the Doxygen code 2018-12-03 23:40:12 +02:00
group.cpp From 22% of cpu in hasTransientInternal to 0.2x% 2018-01-22 20:15:01 +01:00
group.h Improve updating user timestamp 2014-06-03 13:59:10 +02:00
HACKING.md Introduce a new HACKING.md document to replace the previous HACKING 2018-12-17 18:11:59 +01:00
idle_inhibition.cpp [wayland] Check presence of the inhibitor object when a client is registered in IdleInhibition 2018-11-29 18:17:34 +02:00
idle_inhibition.h Fix possible heap-use-after-free in idle inhibition handling 2017-12-03 18:01:43 +01:00
input.cpp Introduce a command line option to disable any kind of global shortcuts 2018-12-13 19:36:28 +01:00
input.h Unset touch targets on no current touch points 2018-12-13 10:59:07 +01:00
input_event.cpp Pass SwitchEvent from LibInput through KWin and add to DebugConsole 2018-01-09 19:32:58 +01:00
input_event.h Pass SwitchEvent from LibInput through KWin and add to DebugConsole 2018-01-09 19:32:58 +01:00
input_event_spy.cpp Pass SwitchEvent from LibInput through KWin and add to DebugConsole 2018-01-09 19:32:58 +01:00
input_event_spy.h Pass SwitchEvent from LibInput through KWin and add to DebugConsole 2018-01-09 19:32:58 +01:00
keyboard_input.cpp Introduce a command line option to disable any kind of global shortcuts 2018-12-13 19:36:28 +01:00
keyboard_input.h Split KWin::Xkb into a dedicated .h and .cpp 2017-02-15 17:48:55 +01:00
keyboard_layout.cpp Fix warning 2018-04-06 18:43:12 +02:00
keyboard_layout.h Introduce support for keyboard layout switching policies 2017-04-22 08:15:25 +02:00
keyboard_layout_switching.cpp Use end() instead of constEnd() for where we compare to an iterator 2017-04-22 20:28:12 +02:00
keyboard_layout_switching.h Add support for keyboard layout switching policy "winclass" 2017-04-22 08:15:59 +02:00
keyboard_repeat.cpp Split Keyboard Repeat handling into a dedicated InputEventSpy 2017-01-27 16:03:37 +01:00
keyboard_repeat.h Split Keyboard Repeat handling into a dedicated InputEventSpy 2017-01-27 16:03:37 +01:00
killwindow.cpp Use OnScreenNotification in kill window 2016-12-21 19:45:02 +01:00
killwindow.h Support interactive window selection through the Platform 2016-11-17 08:08:56 +01:00
kwin.kcfg Drop OpenGL based color correction from KWin 2016-11-22 07:16:51 +01:00
kwin.notifyrc SVN_SILENT made messages (.desktop file) - always resolve ours 2018-11-22 06:02:11 +01:00
kwinbindings.cpp Expose more default window management shortcuts 2018-03-16 17:18:55 -06:00
KWinDBusInterfaceConfig.cmake.in Add path to kwin_wayland binary to KWin's installed CMakeConfig 2015-11-19 09:28:16 +01:00
lanczosfilter.cpp Raise minimum required Mesa version to 10.0 2017-07-06 20:45:58 +02:00
lanczosfilter.h Move SceneOpenGL into a dedicated plugin 2017-09-30 13:12:10 +02:00
layers.cpp Keep Deleted transients above old parents 2018-10-16 18:58:17 +03:00
logind.cpp logind: Add a function that detects the logind seat. 2018-01-05 22:46:39 +01:00
logind.h logind: Add a function that detects the logind seat. 2018-01-05 22:46:39 +01:00
main.cpp Update about data 2018-12-03 10:31:50 +02:00
main.h Drop OperationModeX11AndWayland and introduce OperationModeWaylandOnly instead 2017-09-30 15:09:06 +02:00
main_wayland.cpp Introduce a command line option to disable any kind of global shortcuts 2018-12-13 19:36:28 +01:00
main_wayland.h Ensure Workspace is only started once in Wayland-only mode 2017-10-01 09:06:51 +02:00
main_x11.cpp Load QtQuick settings 2017-11-01 15:51:21 +00:00
main_x11.h Move everything KCrash related from Application to ApplicationX11 2016-05-09 08:08:49 +02:00
Mainpage.dox
manage.cpp Re-evaluate the window rules when the window class of a Client changes 2018-11-07 09:33:39 +01:00
Messages.sh Fix untranslatable strings in debug_console.ui shortcutdialog.ui 2018-09-17 11:39:47 +02:00
modifier_only_shortcuts.cpp Track the actual pressed keys in ModifierOnlyShortcuts 2017-02-23 16:55:41 +01:00
modifier_only_shortcuts.h Track the actual pressed keys in ModifierOnlyShortcuts 2017-02-23 16:55:41 +01:00
moving_client_x11_filter.cpp Move X11 movingClient handling into a dedicated X11EventFilter 2017-09-01 16:57:43 +02:00
moving_client_x11_filter.h Move X11 movingClient handling into a dedicated X11EventFilter 2017-09-01 16:57:43 +02:00
netinfo.cpp Revert "Revert "Add "SkipSwitcher" to API"" 2018-05-23 23:33:39 -05:00
netinfo.h Create a dedicated X11EventFilter for the events used by RootInfo 2017-09-30 12:57:21 +02:00
onscreennotification.cpp Drop invalid .moc file inclusion 2018-03-04 16:10:18 +01:00
onscreennotification.h Add support for skip close animation to OnScreenMessage 2017-01-25 13:54:34 +01:00
options.cpp Try all supported Compositor Types of the current Platform 2017-10-19 18:26:33 +02:00
options.h Move XRandR event filter into XRandRScreens 2017-09-12 18:53:08 +02:00
org.freedesktop.ScreenSaver.xml Add a copy of org.freedesktop.ScreenSaver.xml for KWin 2014-03-24 16:30:22 +01:00
org.kde.kappmenu.xml Restore global menu support 2017-01-11 10:21:03 +01:00
org.kde.kwin.ColorCorrect.xml [colorcorrection] Night Color - blue light filter at nighttime 2017-12-11 10:58:40 +01:00
org.kde.kwin.Compositing.xml [kcmkwin/compositing] Hide config options which don't make sense if Compositing is required 2016-09-13 15:47:42 +02:00
org.kde.kwin.Effects.xml [kwin] Add a new EffectLoader 2014-03-28 14:04:55 +01:00
org.kde.kwin.OrientationSensor.xml Add DBus interface to OrientationSensor and a persistent configuration 2017-12-26 22:02:47 +01:00
org.kde.KWin.VirtualDesktopManager.xml [wayland] Use the new plasma virtual desktop protocol 2018-11-01 16:35:29 +01:00
org.kde.KWin.xml Add a dbus method getWindowInfo returning same data as queryWindowInfo 2018-12-17 18:12:17 +01:00
orientation_sensor.cpp Add DBus interface to OrientationSensor and a persistent configuration 2017-12-26 22:02:47 +01:00
orientation_sensor.h Add DBus interface to OrientationSensor and a persistent configuration 2017-12-26 22:02:47 +01:00
osd.cpp Add support for skip close animation to OnScreenMessage 2017-01-25 13:54:34 +01:00
osd.h Add support for skip close animation to OnScreenMessage 2017-01-25 13:54:34 +01:00
outline.cpp Move NonComposited Outline into the X11 standalone platform 2017-09-01 17:07:23 +02:00
outline.h Move NonComposited Outline into the X11 standalone platform 2017-09-01 17:07:23 +02:00
outputscreens.cpp Move output refresh rate getter into AbstractOutput 2018-11-14 20:04:29 +01:00
outputscreens.h Move output refresh rate getter into AbstractOutput 2018-11-14 20:04:29 +01:00
overlaywindow.cpp Move the X11 specific OverlayWindow into the platform/x11 2017-08-12 11:32:29 +02:00
overlaywindow.h Move the X11 specific OverlayWindow into the platform/x11 2017-08-12 11:32:29 +02:00
placement.cpp [wayland] Set better placement for XDG Toplevels 2018-10-23 12:37:10 +01:00
placement.h Move implementation of Client::packTo to AbstractClient 2015-10-26 11:30:34 +01:00
platform.cpp Remove unused check 2018-10-25 08:05:13 +02:00
platform.h [colorcorrection] Set gamma through Output class 2018-08-31 11:58:21 +02:00
pointer_input.cpp Rework InputDeviceHandler focus tracking 2018-12-02 21:36:11 +01:00
pointer_input.h Rework InputDeviceHandler focus tracking 2018-12-02 21:36:11 +01:00
popup_input_filter.cpp Cancel popup if the user clicked window decoration of parent window 2017-04-11 20:22:32 +02:00
popup_input_filter.h Initial support for popup window handling 2017-04-07 16:14:50 +02:00
README Drop the COMPLIANCE file 2018-12-15 13:28:18 +01:00
resources.qrc [libkwinglutils] Cleanup Shader API: removal of ShaderType 2016-01-26 09:42:49 +01:00
rootinfo_filter.cpp Create a dedicated X11EventFilter for the events used by RootInfo 2017-09-30 12:57:21 +02:00
rootinfo_filter.h Create a dedicated X11EventFilter for the events used by RootInfo 2017-09-30 12:57:21 +02:00
rules.cpp Support starting the rules_dialog from build dir 2018-11-09 09:24:33 +01:00
rules.h Merge branch 'Plasma/5.12' into Plasma/5.13 2018-05-20 15:41:48 +02:00
sc-apps-kwin.svgz Fix installing of icons 2014-06-02 14:56:42 +02:00
scene.cpp Try to invalidate quad cache when shadow is changed 2018-12-05 20:05:15 +02:00
scene.h Try to invalidate quad cache when shadow is changed 2018-12-05 20:05:15 +02:00
screenedge.cpp Fix minor EBN issues 2018-08-29 21:02:16 +03:00
screenedge.h Fix minor EBN issues in the Doxygen code 2018-12-03 23:40:12 +02:00
screenlockerwatcher.cpp Delay query whether screenlocker is registered till WaylandServer is initialized 2016-08-16 10:17:14 +02:00
screenlockerwatcher.h [autotests/integration] Add ScreenLockerWatcher to the Test::lockScreen and ::unlockScreen 2016-08-16 10:23:37 +02:00
screens.cpp Load Kwin's internal cursors for the highest resolution of attached monitors 2018-06-23 23:26:54 +01:00
screens.h Load Kwin's internal cursors for the highest resolution of attached monitors 2018-06-23 23:26:54 +01:00
settings.kcfgc
shadow.cpp Avoid deleting ourselves midway through updateShadow 2018-12-06 12:55:12 +00:00
shadow.h Fix typo 2018-08-04 22:35:40 +03:00
shell_client.cpp [wayland] Minimize transients together with parent 2018-12-14 21:15:58 +02:00
shell_client.h [wayland] XdgPopup Positioning 2018-10-20 17:17:59 +01:00
shortcutdialog.ui [kwin] Use ui-file for ShortcutDialog 2014-02-27 10:18:37 +01:00
sm.cpp Avoid potential assert in SM saving 2018-06-27 01:36:02 +01:00
sm.h Revert "Remove saving and loading (and client matching by) WM_COMMAND." 2016-06-23 21:07:03 +02:00
tabgroup.cpp Port TabGroup from Client to AbstractClient 2018-05-20 19:50:29 +02:00
tabgroup.h Move TabGroup functionality from Client to AbstractClient 2018-05-20 19:50:35 +02:00
tabletmodemanager.cpp Remove remaining HAVE_INPUT ifdef sections 2018-02-10 20:36:43 +01:00
tabletmodemanager.h Expose if the tablet mode switch is available 2018-01-25 12:46:38 +01:00
TESTING.md Add a TESTING.md document describing how to run the unit test suite 2018-11-09 17:39:01 +01:00
thumbnailitem.cpp Fix minor EBN issues 2018-08-29 21:02:16 +03:00
thumbnailitem.h ThumbnailItem operates on AbstractClient 2015-05-21 13:34:26 +02:00
toplevel.cpp Avoid deleting ourselves midway through updateShadow 2018-12-06 12:55:12 +00:00
toplevel.h Try to invalidate quad cache when shadow is changed 2018-12-05 20:05:15 +02:00
touch_hide_cursor_spy.cpp Hide mouse cursor when interacting with touch screen 2018-12-13 18:55:46 +01:00
touch_hide_cursor_spy.h Hide mouse cursor when interacting with touch screen 2018-12-13 18:55:46 +01:00
touch_input.cpp Leave decoration on touch up only once 2018-12-13 11:06:08 +01:00
touch_input.h Unset touch targets on no current touch points 2018-12-13 10:59:07 +01:00
udev.cpp udev: Only handle devices from the current seat 2018-04-05 19:47:36 +02:00
udev.h udev: Add the ability to query the current framebuffer. 2018-04-05 19:46:20 +02:00
unmanaged.cpp [wayland] Move AbstractClient::desktops from QList to QVector 2018-11-07 16:22:59 +00:00
unmanaged.h [wayland] Move AbstractClient::desktops from QList to QVector 2018-11-07 16:22:59 +00:00
useractions.cpp [wayland] add enter/leave virtual desktop API 2018-11-14 11:08:46 +00:00
useractions.h [wayland] Use the new plasma virtual desktop protocol 2018-11-01 16:35:29 +01:00
utils.cpp Make it easier to debug the virtualkeyboard 2018-12-10 16:28:13 +05:30
utils.h Make it easier to debug the virtualkeyboard 2018-12-10 16:28:13 +05:30
virtual_terminal.cpp Fix build with future glibc (major/minor macros) 2016-04-20 19:03:34 +02:00
virtual_terminal.h [wayland] Don't break if we try to vt-switch to vt we're on 2015-07-20 11:49:41 +02:00
virtualdesktops.cpp [wayland] Use the new plasma virtual desktop protocol 2018-11-01 16:35:29 +01:00
virtualdesktops.h Fix minor EBN issues in the Doxygen code 2018-12-03 23:40:12 +02:00
virtualdesktopsdbustypes.cpp [wayland] Use the new plasma virtual desktop protocol 2018-11-01 16:35:29 +01:00
virtualdesktopsdbustypes.h [wayland] Use the new plasma virtual desktop protocol 2018-11-01 16:35:29 +01:00
virtualkeyboard.cpp Make it easier to debug the virtualkeyboard 2018-12-10 16:28:13 +05:30
virtualkeyboard.h Fix minor EBN issues 2018-08-29 21:02:16 +03:00
virtualkeyboard_dbus.cpp Add DBus protocol to virtual keyboard 2017-10-19 17:59:19 +02:00
virtualkeyboard_dbus.h Add DBus protocol to virtual keyboard 2017-10-19 17:59:19 +02:00
was_user_interaction_x11_filter.cpp Create a dedicated X11EventFilter for recognizing first user interaction 2017-08-19 10:14:53 +02:00
was_user_interaction_x11_filter.h Create a dedicated X11EventFilter for recognizing first user interaction 2017-08-19 10:14:53 +02:00
wayland_cursor_theme.cpp Load Kwin's internal cursors for the highest resolution of attached monitors 2018-06-23 23:26:54 +01:00
wayland_cursor_theme.h Set specific edge cursor shape when resizing 2018-06-11 10:05:07 +01:00
wayland_server.cpp Introduce a command line option to disable any kind of global shortcuts 2018-12-13 19:36:28 +01:00
wayland_server.h Introduce a command line option to disable any kind of global shortcuts 2018-12-13 19:36:28 +01:00
window_property_notify_x11_filter.cpp Clean up includes 2018-08-31 22:58:11 +03:00
window_property_notify_x11_filter.h Add a dedicated X11EventFilter for forwarding property events to the effect system 2017-09-25 20:36:45 +02:00
workspace.cpp [wayland] Send only clients that were on the removed desktop to a new desktop 2018-12-14 14:22:30 +02:00
workspace.h [wayland] Use the new plasma virtual desktop protocol 2018-11-01 16:35:29 +01:00
x11eventfilter.cpp Support multiple event types in X11EventFilter 2016-11-16 07:48:19 +01:00
x11eventfilter.h Support multiple event types in X11EventFilter 2016-11-16 07:48:19 +01:00
xcbutils.cpp Clean debug output 2015-07-20 13:36:27 +02:00
xcbutils.h Fix minor EBN issues 2018-08-29 21:02:16 +03:00
xkb.cpp Support enabling numlock on startup 2018-11-01 17:49:58 +01:00
xkb.h Support enabling numlock on startup 2018-11-01 17:49:58 +01:00
xkb_qt_mapping.h Support mapping QKeyEvent to xkb_keysym_t 2017-09-19 19:09:17 +02:00

- A collection of various documents and links related to KWin is at http://techbase.kde.org/Projects/KWin .


- The mailing list for KWin is kwin@kde.org (https://mail.kde.org/mailman/listinfo/kwin).

- If you want to develop KWin, see file HACKING.

- File CONFIGURATION includes some details on configuring KWin.

- Below is some info for application developers about application interaction
  with the window manager, but it'd need some cleanup.








 This README is meant as an explanation of various window manager related
mechanisms that application developers need to be aware of. As some of these
concepts may be difficult to understand for people not having the required
background knowledge (since sometimes it's difficult even for people who
do have the knowledge), the mechanisms are first briefly explained, and
then an example of fixing the various problems is given.

 For comments, questions, suggestions and whatever use the kwin@kde.org
mailing list.


Table of contents:
==================

- Window relations
    - how to make the window manager know which windows belong together
- Focus stealing prevention
    - how to solve cases where focus stealing prevention doesn't work
      properly automatically



Window relations:
=================

(For now, this explanation of window relations is mainly meant for
focus stealing prevention. To be extended later.)

 All windows created by an application should be organized in a tree
with the root being the application's main window. Note that this is about
toplevel windows, not widgets inside the windows. For example, if you
have KWrite running, with a torn-off toolbar (i.e. a standalone toolbar),
a file save dialog open, and the file save dialog showing a dialog
for creating a directory, the window hiearchy should look like this:


             KWrite mainwindow
              /             \
             /               \
      file save dialog      torn-off toolbar
            \
             \
          create directory dialog

 Each subwindow (i.e. all except for the KWrite mainwindow) points to its
main window (which in turn may have another main window, as in the case
of the file save dialog). When the window manager knows these relations,
it can better arrange the windows (keeping subwindows above their
main windows, preventing activation of a main window of a modal dialog,
and similar). Failing to provide this information to the window manager
may have various results, for example having dialogs positioned below
the main window,

The window property used by subwindows to point to their mainwindows is
called WM_TRANSIENT_FOR. It can be seen by running
'xprop | grep WM_TRANSIENT_FOR' and clicking on a window. If the property
is not present, the window does not (claim to) have any mainwindow.
If the property is present, it's value is the window id of its main window;
window id of any window can be found out by running 'xwininfo'. A window
having WM_TRANSIENT_FOR poiting to another window is said to be transient
for that window.

 In some cases, the WM_TRANSIENT_FOR property may not point to any other
existing window, having value of 0, or pointing to the screen number
('xwininfo -root'). These special values mean that the window is transient
for all other windows in its window group. This should be used only
in rare cases, everytime a specific main window is known, WM_TRANSIENT_FOR
should be pointing to it instead of using one of these special values.
(The explanation why is beyond the scope of this document - just accept it
as a fact.)

 With Qt, the WM_TRANSIENT_FOR property is set by Qt automatically, based
on the toplevel widget's parent. If the toplevel widget is of a normal
type (i.e. not a dialog, toolbar, etc.), Qt doesn't set WM_TRANSIENT_FOR
on it. For special widgets, such as dialogs, WM_TRANSIENT_FOR is set
to point to the widget's parent, if it has a specific parent, otherwise
WM_TRANSIENT_FOR points to the root window.

 As already said above, WM_TRANSIENT_FOR poiting to the root window should
be usually avoided, so everytime the widget's main widget is known, the widget
should get it passed as a parent in its constructor.
(TODO KDialog etc. classes should not have a default argument for the parent
argument, and comments like 'just pass 0 as the parent' should go.)



Focus stealing prevention:
==========================

 Since KDE3.2 KWin has a feature called focus stealing prevention. As the name
suggests, it prevents unexpected changes of focus. With older versions of KWin,
if any application opened a new dialog, it became active, and
if the application's main window was on another virtual desktop, also
the virtual desktop was changed. This was annoying, and also sometimes led
to dialogs mistakenly being closed because they received keyboard input that
was meant for the previously active window.

 The basic principle of focus stealing prevention is that the window with most
recent user activity wins. Any window of an application will become active
when being shown only if this application was the most recently used one.
KWin itself, and some of the related kdecore classes should take care
of the common cases, so usually there's no need for any special handling
in applications. Qt/KDE applications, that is. Applications using other
toolkits should in most cases work fine too. If they don't support
the window property _NET_WM_USER_TIME, the window manager may fail to detect
the user timestamp properly, resulting either in other windows becoming active
while the user works with this application, or this application may sometimes
steal focus (this second case should be very rare though).

 There are also cases where KDE applications needs special handling. The two
most common cases are when windows relations are not setup properly to make
KWin realize that they belong to the same application, and when the user
activity is not represented by manipulating with the application windows
themselves.

 Also note that focus stealing prevention implemented in the window manager
can only help with focus stealing between different applications.
If an application itself suddenly pops up a dialog, KWin cannot do anything about
it, and its the application's job to handle this case.


Window relations:
-----------------

 The common case here is when a dialog is shown for an application, but this
dialog is not provided by the application itself, but by some other process.
For example, dialogs with warnings about accepted cookies are provided
by KCookieJar, instead of being shown by Konqueror. In the normal case,
from KWin's point of view the cookie dialog would be an attempt of another
application to show a dialog, and KWin wouldn't allow activation of this
window.

 The solution is to tell the window manager about the relation between
the Konqueror main window and the cookie dialog, by making the dialog
point to the mainwindow. Note that this is not special to focus stealing
prevention, subwindows such as dialogs, toolbars and similar should always
point to their mainwindow. See the section on window relations for full
description.

 The WM_TRANSIENT_FOR property that's set on dialogs to point to their
mainwindow should in the cookie dialog case point to the Konqueror window
for which it has been shown. This is solved in kcookiejar by including
the window id in the DCOP call. When the cookie dialog is shown, its
WM_TRANSIENT_FOR property is manually set using the XSetTransientForHint()
call (see kdelibs/kioslave/http/kcookiejar/kcookiewin.cpp). The arguments
to XSetTransientForHint() call are the X display (i.e. QX11Info::display()),
the window id on which the WM_TRANSIENT_FOR property is to be set
(i.e. use QWidget::winId()), and the window id of the mainwindow.


  Simple short HOWTO:
  
 To put it simply: Let's say you have a daemon application that has
DCOP call "showDialog( QString text )", and when this is called, it shows
a dialog with the given text. This won't work properly with focus stealing
prevention. The DCOP call should be changed to
"showDialog( QString text, long id )". The caller should pass something like
myMainWindow->winId() as the second argument. In the daemon, before
the dialog is shown, a call to XSetTransientHint() should be added:

 XSetTransientForHint( QX11Info::display(), dialog->winId(), id_of_mainwindow );
 
 That's it.

Non-standard user activity:
---------------------------

 The most common case in KDE will be DCOP calls. For example, KDesktop's DCOP
call "KDesktopIface popupExecuteCommand". Executing this DCOP call e.g.
from Konsole as 'dcop kdesktop KDesktopIface popupExecuteCommand" will lead
to showing the minicli, but the last user activity timestamp gained from events
sent by X server will be older than user activity timestamp of Konsole, and
would normally result in minicli not being active. Therefore, before showing
the minicli, kdesktop needs to call KApplication::updateUserTimestamp().

 However, this shouldn't be done with all DCOP calls. If a DCOP call is not
a result of direct user action, calling KApplication::updateUserTimestamp()
would lead to focus stealing. For example, let's assume for a moment
that KMail would use this DCOP call in case it detects the modem is not
connected, allowing to you to start KPPP or whatever tool you use. If KMail
would be configured to check mail every 10 minutes, this would lead to minicli
possibly suddenly showing up at every check. Basically, doing the above change
to kdesktop's minicli means that the popupExecuteCommand() DCOP call is only
for user scripting. (TODO write about focus transferring?)

 Simply said, KApplication::updateUserTimestamp() should be called only
as a result of user action. Unfortunately, I'm not aware of any universal
way how to handle this, so every case will have to be considered separately.