This interface manages application windows.
It provides requests to show and hide the desktop and emits
an event every time a window is created so that the client can
use it to manage the window.
Only one client can bind this interface at a time.
Warning! The protocol described in this file is a desktop environment
implementation detail. Regular clients must not use this protocol.
Backward incompatible changes may be added without bumping the major
version of the extension.
Tell the compositor to show/hide the desktop.
Deprecated: use get_window_by_uuid
This event will be sent whenever the show desktop mode changes. E.g. when it is entered
or left.
On binding the interface the current state is sent.
This event will be sent immediately after a window is mapped.
This event will be sent when stacking order changed and on bind.
With version 17 this event is deprecated and will no longer be sent.
This event will be sent when stacking order changed and on bind.
With version 17 this event is deprecated and will no longer be sent.
This event will be sent immediately after a window is mapped.
This event will be sent when stacking order changed.
Manages and control an application window.
Only one client can bind this interface at a time.
Set window state.
Values for state argument are described by org_kde_plasma_window_management.state
and can be used together in a bitfield. The flags bitfield describes which flags are
supposed to be set, the state bitfield the value for the set flags
Deprecated: use enter_virtual_desktop
Maps the window to a different virtual desktop.
To show the window on all virtual desktops, call the
org_kde_plasma_window.set_state request and specify a on_all_desktops
state in the bitfield.
Sets the geometry of the taskbar entry for this window.
The geometry is relative to a panel in particular.
Remove the task geometry information for a particular panel.
Close this window.
Request an interactive move for this window.
Request an interactive resize for this window.
Removes the resource bound for this org_kde_plasma_window.
The compositor will write the window icon into the provided file descriptor.
The data is a serialized QIcon with QDataStream.
This event will be sent as soon as the window title is changed.
This event will be sent as soon as the application
identifier is changed.
This event will be sent as soon as the window state changes.
Values for state argument are described by org_kde_plasma_window_management.state.
DEPRECATED: use virtual_desktop_entered and virtual_desktop_left instead
This event will be sent when a window is moved to another
virtual desktop.
It is not sent if it becomes visible on all virtual desktops though.
This event will be sent whenever the themed icon name changes. May be null.
This event will be sent immediately after the window is closed
and its surface is unmapped.
This event will be sent immediately after all initial state been sent to the client.
If the Plasma window is already unmapped, the unmapped event will be sent before the
initial_state event.
This event will be sent whenever the parent window of this org_kde_plasma_window changes.
The passed parent is another org_kde_plasma_window and this org_kde_plasma_window is a
transient window to the parent window. If the parent argument is null, this
org_kde_plasma_window does not have a parent window.
This event will be sent whenever the window geometry of this org_kde_plasma_window changes.
The coordinates are in absolute coordinates of the windowing system.
This event will be sent whenever the icon of the window changes, but there is no themed
icon name. Common examples are Xwayland windows which have a pixmap based icon.
The client can request the icon using get_icon.
This event will be sent when the compositor has set the process id this window belongs to.
This should be set once before the initial_state is sent.
Make the window enter a virtual desktop. A window can enter more
than one virtual desktop. if the id is empty or invalid, no action will be performed.
RFC: do this with an empty id to request_enter_virtual_desktop?
Make the window enter a new virtual desktop. If the server consents the request,
it will create a new virtual desktop and assign the window to it.
Make the window exit a virtual desktop. If it exits all desktops it will be considered on all of them.
This event will be sent when the window has entered a new virtual desktop. The window can be on more than one desktop, or none: then is considered on all of them.
This event will be sent when the window left a virtual desktop. If the window leaves all desktops, it can be considered on all.
If the window gets manually added on all desktops, the server has to send virtual_desktop_left for every previous desktop it was in for the window to be really considered on all desktops.
This event will be sent after the application menu
for the window has changed.
Make the window enter an activity. A window can enter more activity. If the id is empty or invalid, no action will be performed.
Make the window exit a an activity. If it exits all activities it will be considered on all of them.
This event will be sent when the window has entered an activity. The window can be on more than one activity, or none: then is considered on all of them.
This event will be sent when the window left an activity. If the window leaves all activities, it will be considered on all.
If the window gets manually added on all activities, the server has to send activity_left for every previous activity it was in for the window to be really considered on all activities.
Requests this window to be displayed in a specific output.
This event will be sent when the X11 resource name of the window has changed.
This is only set for XWayland windows.
This event will be sent whenever the window geometry of this org_kde_plasma_window changes.
The coordinates are in absolute coordinates of the windowing system.
The activation manager interface provides a way to get notified
when an application is about to be activated.
Destroy the activation manager object. The activation objects introduced
by this manager object will be unaffected.
Will be issued when an app is set to be activated. It offers
an instance of org_kde_plasma_activation that will tell us the app_id
and the extent of the activation.
Notify the compositor that the org_kde_plasma_activation object will no
longer be used.
When this object is created, the compositor sends a window event for
each window in the stacking order, and afterwards sends the done event
and destroys this object.