summaryrefslogtreecommitdiffstats
path: root/wm-spec/wm-spec.sgml
diff options
context:
space:
mode:
Diffstat (limited to 'wm-spec/wm-spec.sgml')
-rw-r--r--wm-spec/wm-spec.sgml86
1 files changed, 84 insertions, 2 deletions
diff --git a/wm-spec/wm-spec.sgml b/wm-spec/wm-spec.sgml
index e3ea8a8..501823d 100644
--- a/wm-spec/wm-spec.sgml
+++ b/wm-spec/wm-spec.sgml
@@ -16,7 +16,7 @@
<title>Version</title>
<para>
This is DRAFT version 1.2 of the Extended Window Manager Hints (EWMH) spec,
-updated October 11 2001.
+updated October 17 2001.
</para>
</sect2>
<sect2>
@@ -741,7 +741,86 @@ _NET_WM_STATE_TOGGLE 2 /* toggle property */
<para>
See also the implementation notes on <link linkend="URGENCY">urgency</link> and <link linkend="NORESIZE">fixed size windows</link>.
</para>
- </sect2><sect2><title>_NET_WM_STRUT</title>
+ </sect2>
+
+ <sect2>
+ <title>_NET_WM_ALLOWED_ACTIONS</title>
+ <programlisting><![CDATA[
+_NET_WM_ALLOWED_ACTIONS, ATOM[]
+]]></programlisting>
+ <para>
+A list of atoms indicating user operations that the window manager supports for
+this window. Atoms present in the list indicate allowed actions, atoms not
+present in the list indicate actions that are not supported for this window.
+The window manager MUST keep this property updated to reflect the
+actions which are currently "active" or "sensitive" for a window.
+Taskbars, pagers, and other tools use _NET_WM_ALLOWED_ACTIONS to
+decide which actions should be made available to the user.
+ </para>
+ <para>
+Possible atoms are:
+ </para>
+ <programlisting><![CDATA[
+_NET_WM_ACTION_MOVE, ATOM
+_NET_WM_ACTION_RESIZE, ATOM
+_NET_WM_ACTION_SHADE, ATOM
+_NET_WM_ACTION_STICK, ATOM
+_NET_WM_ACTION_MAXIMIZE_HORZ, ATOM
+_NET_WM_ACTION_MAXIMIZE_VERT, ATOM
+_NET_WM_ACTION_CHANGE_DESKTOP, ATOM
+_NET_WM_ACTION_CLOSE, ATOM
+]]></programlisting>
+ <para>
+An implementation MAY add new atoms to this list. Implementations
+without extensions MUST ignore any unknown atoms, effectively removing
+them from the list. These extension atoms MUST NOT start with the prefix
+_NET.
+ </para>
+ <para>
+Note that the actions listed here are those that the <emphasis>window
+manager</emphasis> will honor for this window. The operations must still be
+requested through the normal mechanisms outlined in this specification. For
+example, _NET_WM_ACTION_CLOSE does not mean that clients can send a
+WM_DELETE_WINDOW message to this window; it means that clients can use a
+_NET_CLOSE_WINDOW message to ask the window manager to do so.
+ </para>
+ <para>
+Window managers SHOULD ignore the value of _NET_WM_ALLOWED_ACTIONS when they
+initially manage a window. This value may be left over from a previous window
+manager with different policies.
+ </para>
+ <para>
+_NET_WM_ACTION_MOVE indicates that the window may be moved around the screen.
+ </para>
+ <para>
+_NET_WM_ACTION_RESIZE indicates that the window may be resized.
+(Implementation note: window managers can identify a non-resizable
+window because its minimum and maximum size in WM_NORMAL_HINTS will be the same.)
+ </para>
+ <para>
+_NET_WM_ACTION_SHADE indicates that the window may be shaded.
+ </para>
+ <para>
+_NET_WM_ACTION_STICK indicates that the window may have its sticky state
+toggled (as for _NET_WM_STATE_STICKY). Note that this state has to do with
+viewports, not desktops.
+ </para>
+ <para>
+_NET_WM_ACTION_MAXIMIZE_HORZ indicates that the window may be maximized horizontally.
+ </para>
+ <para>
+_NET_WM_ACTION_MAXIMIZE_VERT indicates that the window may be maximized vertically.
+ </para>
+ <para>
+_NET_WM_ACTION_CHANGE_DESKTOP indicates that the window may be moved between desktops.
+ </para>
+ <para>
+_NET_WM_ACTION_CLOSE indicates that the window may be closed (i.e. a WM_DELETE_WINDOW
+message may be sent).
+ </para>
+</sect2>
+
+<sect2><title>_NET_WM_STRUT</title>
<programlisting id="NETWMSTRUT"><![CDATA[
_NET_WM_STRUT, left, right, top, bottom, CARDINAL[4]/32
]]></programlisting>
@@ -1250,6 +1329,9 @@ OR OTHER DEALINGS IN THE SOFTWARE.
<listitem><para>
Added _NET_WM_STATE_FULLSCREEN.
</para></listitem>
+ <listitem><para>
+ Added _NET_WM_ALLOWED_ACTIONS.
+ </para></listitem>
</itemizedlist>
</sect2>
<sect2>