ed4a0d0319
This provides a new protocol intended to be used by auto-hiding panels to make use of the centralized screen edges. To use it a Client can set an X11 property of type _KDE_NET_WM_SCREEN_EDGE_SHOW to KWin. As value it takes: * 0: top edge * 1: right edge * 2: bottom edge * 3: left edge KWin will hide the Client (hide because unmap or minimize would break it) and create an Edge. If that Edge gets triggered the Client is shown again and the property gets deleted. If the Client doesn't border the specified screen edge the Client gets shown immediately so that we never end in a situation that we cannot unhide the auto-hidden panel again. The exact process is described in the documentation of ScreenEdges. The Client can request to be shown again by deleting the property. If KWin gets restarted the state is read from the property and it is tried to create the edge as described. As this is a KWin specific extension we need to discuss what it means for Clients using this feature with other WMs: it does nothing. As the Client gets hidden by KWin and not by the Client, it just doesn't get hidden if the WM doesn't provide the feature. In case of an auto-hiding panel this seems like a good solution given that we don't want to hide it if we cannot unhide it. Of course there's the option for the Client to provide that feature itself and if that's wanted we would need to announce the feature in the _NET_SUPPORTED atom. At the moment that doesn't sound like being needed as Plasma doesn't want to provide an own implementation. The implementation comes with a small test application showing how the feature is intended to be used. REVIEW: 115910
89 lines
2.5 KiB
C++
89 lines
2.5 KiB
C++
/********************************************************************
|
|
KWin - the KDE window manager
|
|
This file is part of the KDE project.
|
|
|
|
Copyright (C) 1999, 2000 Matthias Ettrich <ettrich@kde.org>
|
|
Copyright (C) 2003 Lubos Lunak <l.lunak@kde.org>
|
|
Copyright (C) 2013 Martin Gräßlin <mgraesslin@kde.org>
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; either version 2 of the License, 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 General Public License
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*********************************************************************/
|
|
|
|
#ifndef KWIN_ATOMS_H
|
|
#define KWIN_ATOMS_H
|
|
|
|
#include "xcbutils.h"
|
|
|
|
namespace KWin
|
|
{
|
|
|
|
class Atoms
|
|
{
|
|
public:
|
|
Atoms();
|
|
|
|
Xcb::Atom kwin_running;
|
|
Xcb::Atom activities;
|
|
|
|
Xcb::Atom wm_protocols;
|
|
Xcb::Atom wm_delete_window;
|
|
Xcb::Atom wm_take_focus;
|
|
Xcb::Atom wm_change_state;
|
|
Xcb::Atom wm_client_leader;
|
|
Xcb::Atom wm_window_role;
|
|
Xcb::Atom wm_state;
|
|
Xcb::Atom sm_client_id;
|
|
|
|
Xcb::Atom motif_wm_hints;
|
|
Xcb::Atom net_wm_context_help;
|
|
Xcb::Atom net_wm_ping;
|
|
Xcb::Atom kde_wm_change_state;
|
|
Xcb::Atom net_wm_user_time;
|
|
Xcb::Atom kde_net_wm_user_creation_time;
|
|
Xcb::Atom kde_system_tray_embedding;
|
|
Xcb::Atom net_wm_take_activity;
|
|
Xcb::Atom net_wm_window_opacity;
|
|
Xcb::Atom xdnd_aware;
|
|
Xcb::Atom xdnd_position;
|
|
Xcb::Atom net_frame_extents;
|
|
Xcb::Atom kde_net_wm_frame_strut;
|
|
Xcb::Atom net_wm_sync_request_counter;
|
|
Xcb::Atom net_wm_sync_request;
|
|
Xcb::Atom kde_net_wm_block_compositing;
|
|
Xcb::Atom kde_net_wm_shadow;
|
|
Xcb::Atom net_wm_opaque_region;
|
|
Xcb::Atom kde_net_wm_tab_group;
|
|
Xcb::Atom kde_first_in_window_list;
|
|
Xcb::Atom kde_color_sheme;
|
|
Xcb::Atom kde_skip_close_animation;
|
|
Xcb::Atom kde_screen_edge_show;
|
|
|
|
/**
|
|
* @internal
|
|
**/
|
|
void retrieveHelpers();
|
|
|
|
private:
|
|
// helper atoms we need to resolve to "announce" support (see #172028)
|
|
Xcb::Atom m_dtSmWindowInfo;
|
|
Xcb::Atom m_motifSupport;
|
|
bool m_helpersRetrieved;
|
|
};
|
|
|
|
|
|
extern Atoms* atoms;
|
|
|
|
} // namespace
|
|
|
|
#endif
|