diff options
Diffstat (limited to 'libX11/specs/libX11/CH03.xml')
| -rw-r--r-- | libX11/specs/libX11/CH03.xml | 800 |
1 files changed, 400 insertions, 400 deletions
diff --git a/libX11/specs/libX11/CH03.xml b/libX11/specs/libX11/CH03.xml index a90a06821..8b6fb3478 100644 --- a/libX11/specs/libX11/CH03.xml +++ b/libX11/specs/libX11/CH03.xml @@ -25,11 +25,11 @@ the default depth of the default root window, and the default visual type <para>
<!-- .LP -->
Xlib uses an opaque
-<function>Visual </function>
+<structname>Visual</structname>
<indexterm significance="preferred"><primary>Visual</primary></indexterm>
structure that contains information about the possible color mapping.
The visual utility functions (see section 16.7) use an
-<function>XVisualInfo</function>
+<structname>XVisualInfo</structname>
structure to return this information to an application.
The members of this structure pertinent to this discussion are class, red_mask,
green_mask, blue_mask, bits_per_rgb, and colormap_size.
@@ -41,13 +41,13 @@ and can be <indexterm><primary>Visual Classes</primary><secondary>StaticColor</secondary></indexterm>
<indexterm><primary>Visual Classes</primary><secondary>GrayScale</secondary></indexterm>
<indexterm><primary>Visual Classes</primary><secondary>PseudoColor</secondary></indexterm>
-<function>StaticGray</function>,
-<function>StaticColor</function>,
-<function>TrueColor</function>,
-<function>GrayScale</function>,
-<function>PseudoColor</function>,
+<symbol>StaticGray</symbol>,
+<symbol>StaticColor</symbol>,
+<symbol>TrueColor</symbol>,
+<symbol>GrayScale</symbol>,
+<symbol>PseudoColor</symbol>,
or
-<function>DirectColor</function>.
+<symbol>DirectColor</symbol>.
</para>
<para>
<!-- .LP -->
@@ -89,16 +89,16 @@ the <acronym>RGB</acronym> values in the following ways: <listitem>
<para>
For
-<function>PseudoColor</function>,
+<symbol>PseudoColor</symbol>,
a pixel value indexes a colormap to produce
independent <acronym>RGB</acronym> values, and the <acronym>RGB</acronym> values can be changed dynamically.
</para>
</listitem>
<listitem>
<para>
-<function>GrayScale </function>
+<symbol>GrayScale</symbol>
is treated the same way as
-<function>PseudoColor </function>
+<symbol>PseudoColor</symbol>
except that the primary that drives the screen is undefined.
Thus, the client should always store the
same value for red, green, and blue in the colormaps.
@@ -107,7 +107,7 @@ same value for red, green, and blue in the colormaps. <listitem>
<para>
For
-<function>DirectColor</function>,
+<symbol>DirectColor</symbol>,
a pixel value is decomposed into separate <acronym>RGB</acronym> subfields, and each
subfield separately indexes the colormap for the corresponding value.
The <acronym>RGB</acronym> values can be changed dynamically.
@@ -115,9 +115,9 @@ The <acronym>RGB</acronym> values can be changed dynamically. </listitem>
<listitem>
<para>
-<function>TrueColor</function>
+<symbol>TrueColor</symbol>
is treated the same way as
-<function>DirectColor </function>
+<symbol>DirectColor</symbol>
except that the colormap has predefined, read-only <acronym>RGB</acronym> values.
These <acronym>RGB</acronym> values are server dependent but provide linear or near-linear
ramps in each primary.
@@ -125,21 +125,21 @@ ramps in each primary. </listitem>
<listitem>
<para>
-<function>StaticColor</function>
+<symbol>StaticColor</symbol>
is treated the same way as
-<function>PseudoColor </function>
+<symbol>PseudoColor</symbol>
except that the colormap has predefined,
read-only, server-dependent <acronym>RGB</acronym> values.
</para>
</listitem>
<listitem>
<para>
-<function>StaticGray </function>
+<symbol>StaticGray</symbol>
is treated the same way as
-<function>StaticColor </function>
+<symbol>StaticColor</symbol>
except that the <acronym>RGB</acronym> values are equal for any single pixel
value, thus resulting in shades of gray.
-<function>StaticGray </function>
+<symbol>StaticGray</symbol>
with a two-entry
colormap can be thought of as monochrome.
</para>
@@ -148,9 +148,9 @@ colormap can be thought of as monochrome. <para>
<!-- .LP -->
The red_mask, green_mask, and blue_mask members are only defined for
-<function>DirectColor</function>
+<symbol>DirectColor</symbol>
and
-<function>TrueColor</function>.
+<symbol>TrueColor</symbol>.
Each has one contiguous set of bits with no
intersections.
The bits_per_rgb member specifies the log base 2 of the
@@ -159,23 +159,23 @@ Actual <acronym>RGB</acronym> values are unsigned 16-bit numbers. The colormap_size member defines the number of available colormap entries
in a newly created colormap.
For
-<function>DirectColor </function>
+<symbol>DirectColor</symbol>
and
-<function>TrueColor</function>,
+<symbol>TrueColor</symbol>,
this is the size of an individual pixel subfield.
<!-- .sp -->
</para>
<para>
<!-- .LP -->
To obtain the visual ID from a
-<function>Visual</function>,
+<structname>Visual</structname>,
use
<function>XVisualIDFromVisual</function>.
<indexterm significance="preferred"><primary>XVisualIDFromVisual</primary></indexterm>
<!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef>VisualID<function> XVisualIDFromVisual</function></funcdef>
+ <funcdef>VisualID <function>XVisualIDFromVisual</function></funcdef>
<paramdef>Visual<parameter> *\^visual</parameter></paramdef>
</funcprototype>
</funcsynopsis>
@@ -211,7 +211,7 @@ function returns the visual ID for the specified visual type. <indexterm><primary>Window</primary></indexterm>
<indexterm><primary>Window</primary><secondary>attributes</secondary></indexterm>
All
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
windows have a border width of zero or more pixels, an optional background,
an event suppression mask (which suppresses propagation of events from
children), and a property list (see section 4.3).
@@ -233,12 +233,12 @@ Windows also have associated property lists (see section 4.3). <para>
<!-- .LP -->
Both
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
and
-<function>InputOnly</function>
+<symbol>InputOnly</symbol>
windows have the following common attributes,
which are the only attributes of an
-<function>InputOnly</function>
+<symbol>InputOnly</symbol>
window:
</para>
<itemizedlist>
@@ -271,26 +271,26 @@ cursor <para>
<!-- .LP -->
If you specify any other attributes for an
-<function>InputOnly</function>
+<symbol>InputOnly</symbol>
window,
a
-<function>BadMatch</function>
+<errorname>BadMatch</errorname>
error results.
</para>
<para>
<!-- .LP -->
-<function>InputOnly</function>
+<symbol>InputOnly</symbol>
windows are used for controlling input events in situations where
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
windows are unnecessary.
-<function>InputOnly</function>
+<symbol>InputOnly</symbol>
windows are invisible; can only be used to control such things as
cursors, input event generation, and grabbing;
and cannot be used in any graphics requests.
Note that
-<function>InputOnly</function>
+<symbol>InputOnly</symbol>
windows cannot have
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
windows as inferiors.
</para>
<para>
@@ -308,7 +308,7 @@ are to be made. The pattern can either be relative to the parent
or absolute.
If
-<function>ParentRelative</function>,
+<symbol>ParentRelative</symbol>,
the parent's background is used.
</para>
<para>
@@ -325,7 +325,7 @@ When a window is eventually mapped to the screen <function>XMapWindow</function>),
<indexterm><primary>XMapWindow</primary></indexterm>
the X server generates an
-<function>Expose </function>
+<symbol>Expose</symbol>
event for the window if backing store has not been maintained.
</para>
<para>
@@ -346,7 +346,7 @@ for window managers. <!-- .LP -->
To set an attribute of a window,
set the appropriate member of the
-<function>XSetWindowAttributes</function>
+<structname>XSetWindowAttributes</structname>
structure and OR in the corresponding value bitmask in your subsequent calls to
<function>XCreateWindow</function>
and
@@ -354,7 +354,7 @@ and or use one of the other convenience functions that set the appropriate
attribute.
The symbols for the value mask bits and the
-<function>XSetWindowAttributes</function>
+<structname>XSetWindowAttributes</structname>
structure are:
<!-- .sM -->
</para>
@@ -412,9 +412,9 @@ typedef struct { <!-- .eM -->
The following lists the defaults for each window attribute and indicates
whether the attribute is applicable to
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
and
-<function>InputOnly</function>
+<symbol>InputOnly</symbol>
windows:
</para>
<informaltable>
@@ -434,7 +434,7 @@ windows: <tbody>
<row>
<entry>background-pixmap</entry>
- <entry><function>None</function></entry>
+ <entry><symbol>None</symbol></entry>
<entry>Yes</entry>
<entry>No</entry>
</row>
@@ -446,7 +446,7 @@ windows: </row>
<row>
<entry>border-pixmap</entry>
- <entry><function>CopyFromParent</function></entry>
+ <entry><symbol>CopyFromParent</symbol></entry>
<entry>Yes</entry>
<entry>No</entry>
</row>
@@ -458,19 +458,19 @@ windows: </row>
<row>
<entry>bit-gravity</entry>
- <entry><function>ForgetGravity</function></entry>
+ <entry><symbol>ForgetGravity</symbol></entry>
<entry>Yes</entry>
<entry>No</entry>
</row>
<row>
<entry>win-gravity</entry>
- <entry><function>NorthWestGravity</function></entry>
+ <entry><symbol>NorthWestGravity</symbol></entry>
<entry>Yes</entry>
<entry>Yes</entry>
</row>
<row>
<entry>backing-store</entry>
- <entry><function>NotUseful</function></entry>
+ <entry><symbol>NotUseful</symbol></entry>
<entry>Yes</entry>
<entry>No</entry>
</row>
@@ -488,7 +488,7 @@ windows: </row>
<row>
<entry>save-under</entry>
- <entry><function>False</function></entry>
+ <entry><symbol>False</symbol></entry>
<entry>Yes</entry>
<entry>No</entry>
</row>
@@ -506,19 +506,19 @@ windows: </row>
<row>
<entry>override-redirect</entry>
- <entry><function>False</function></entry>
+ <entry><symbol>False</symbol></entry>
<entry>Yes</entry>
<entry>Yes</entry>
</row>
<row>
<entry>colormap</entry>
- <entry><function>CopyFromParent</function></entry>
+ <entry><symbol>CopyFromParent</symbol></entry>
<entry>Yes</entry>
<entry>No</entry>
</row>
<row>
<entry>cursor</entry>
- <entry><function>None</function></entry>
+ <entry><symbol>None</symbol></entry>
<entry>Yes</entry>
<entry>Yes</entry>
</row>
@@ -534,10 +534,10 @@ windows: <para>
<!-- .LP -->
Only
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
windows can have a background.
You can set the background of an
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
window by using a pixel or a pixmap.
</para>
<para>
@@ -551,9 +551,9 @@ a window's background in a single color. <para>
<!-- .LP -->
You can set the background-pixmap to a pixmap,
-<function>None </function>
+<symbol>None</symbol>
(default), or
-<function>ParentRelative</function>.
+<symbol>ParentRelative</symbol>.
You can set the background-pixel of a window to any pixel value (no default).
If you specify a background-pixel,
it overrides either the default background-pixmap
@@ -569,13 +569,13 @@ If you set the background-pixmap, it overrides the default.
The background-pixmap and the window must have the same depth,
or a
-<function>BadMatch</function>
+<errorname>BadMatch</errorname>
error results.
If you set background-pixmap to
-<function>None</function>,
+<symbol>None</symbol>,
the window has no defined background.
If you set the background-pixmap to
-<function>ParentRelative :</function>
+<symbol>ParentRelative</symbol>:
</para>
<itemizedlist>
<listitem>
@@ -584,16 +584,16 @@ The parent window's background-pixmap is used. The child window, however, must have the same depth as
its parent,
or a
-<function>BadMatch</function>
+<errorname>BadMatch</errorname>
error results.
</para>
</listitem>
<listitem>
<para>
If the parent window has a background-pixmap of
-<function>None</function>,
+<symbol>None</symbol>,
the window also has a background-pixmap of
-<function>None</function>.
+<symbol>None</symbol>.
</para>
</listitem>
<listitem>
@@ -608,7 +608,7 @@ background-pixmap is required. The background tile origin always aligns with the parent window's
background tile origin.
If the background-pixmap is not
-<function>ParentRelative</function>,
+<symbol>ParentRelative</symbol>,
the background tile origin is the child window's origin.
</para>
</listitem>
@@ -630,17 +630,17 @@ When no valid contents are available for regions of a window and either the regions are visible or the server is maintaining backing store,
the server automatically tiles the regions with the window's background
unless the window has a background of
-<function>None</function>.
+<symbol>None</symbol>.
If the background is
-<function>None</function>,
+<symbol>None</symbol>,
the previous screen contents from other windows of the same depth as the window
are simply left in place as long as the contents come from the parent of the
window or an inferior of the parent.
Otherwise, the initial contents of the exposed regions are undefined.
-<function>Expose </function>
+<symbol>Expose</symbol>
events are then generated for the regions, even if the background-pixmap
is
-<function>None </function>
+<symbol>None</symbol>
(see section 10.9).
</para>
</sect2>
@@ -652,10 +652,10 @@ is <para>
<!-- .LP -->
Only
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
windows can have a border.
You can set the border of an
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
window by using a pixel or a pixmap.
</para>
<para>
@@ -672,7 +672,7 @@ The border tile origin is always the same as the background tile origin. <!-- .LP -->
You can also set the border-pixmap to a pixmap of any size (some may be faster
than others) or to
-<function>CopyFromParent </function>
+<symbol>CopyFromParent</symbol>
(default).
You can set the border-pixel to any pixel value (no default).
</para>
@@ -682,16 +682,16 @@ If you set a border-pixmap, it overrides the default.
The border-pixmap and the window must have the same depth,
or a
-<function>BadMatch</function>
+<errorname>BadMatch</errorname>
error results.
If you set the border-pixmap to
-<function>CopyFromParent</function>,
+<symbol>CopyFromParent</symbol>,
the parent window's border-pixmap is copied.
Subsequent changes to the parent window's border attribute do not affect
the child window.
However, the child window must have the same depth as the parent window,
or a
-<function>BadMatch</function>
+<errorname>BadMatch</errorname>
error results.
</para>
<para>
@@ -724,17 +724,17 @@ Therefore, graphics operations never affect the window border. <!-- .LP -->
The bit gravity of a window defines which region of the window should be
retained when an
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
window is resized.
The default value for the bit-gravity attribute is
-<function>ForgetGravity</function>.
+<symbol>ForgetGravity</symbol>.
The window gravity of a window allows you to define how the
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
or
-<function>InputOnly</function>
+<symbol>InputOnly</symbol>
window should be repositioned if its parent is resized.
The default value for the win-gravity attribute is
-<function>NorthWestGravity</function>.
+<symbol>NorthWestGravity</symbol>.
</para>
<para>
<!-- .LP -->
@@ -761,39 +761,39 @@ change of width and height, the (x, y) pairs are defined: </thead>
<tbody>
<row>
- <entry><function>NorthWestGravity</function></entry>
+ <entry><symbol>NorthWestGravity</symbol></entry>
<entry>(0, 0)</entry>
</row>
<row>
- <entry><function>NorthGravity</function></entry>
+ <entry><symbol>NorthGravity</symbol></entry>
<entry>(Width/2, 0)</entry>
</row>
<row>
- <entry><function>NorthEastGravity</function></entry>
+ <entry><symbol>NorthEastGravity</symbol></entry>
<entry>(Width, 0)</entry>
</row>
<row>
- <entry><function>WestGravity</function></entry>
+ <entry><symbol>WestGravity</symbol></entry>
<entry>(0, Height/2)</entry>
</row>
<row>
- <entry><function>CenterGravity</function></entry>
+ <entry><symbol>CenterGravity</symbol></entry>
<entry>(Width/2, Height/2)</entry>
</row>
<row>
- <entry><function>EastGravity</function></entry>
+ <entry><symbol>EastGravity</symbol></entry>
<entry>(Width, Height/2)</entry>
</row>
<row>
- <entry><function>SouthWestGravity</function></entry>
+ <entry><symbol>SouthWestGravity</symbol></entry>
<entry>(0, Height)</entry>
</row>
<row>
- <entry><function>SouthGravity</function></entry>
+ <entry><symbol>SouthGravity</symbol></entry>
<entry>(Width/2, Height)</entry>
</row>
<row>
- <entry><function>SouthEastGravity</function></entry>
+ <entry><symbol>SouthEastGravity</symbol></entry>
<entry>(Width, Height)</entry>
</row>
</tbody>
@@ -809,13 +809,13 @@ When a window with one of these win-gravities has its parent window resized, the corresponding pair defines the change in position of the window
within the parent.
When a window is so repositioned, a
-<function>GravityNotify</function>
+<symbol>GravityNotify</symbol>
event is generated (see section 10.10.5).
</para>
<para>
<!-- .LP -->
A bit-gravity of
-<function>StaticGravity </function>
+<symbol>StaticGravity</symbol>
indicates that the contents or origin should not move relative to the
origin of the root window.
If the change in size of the window is coupled with a change in position (x, y),
@@ -823,25 +823,25 @@ then for bit-gravity the change in position of each pixel is (\-x, \-y), and for win-gravity the change in position of a child when its parent is so resized is
(\-x, \-y).
Note that
-<function>StaticGravity</function>
+<symbol>StaticGravity</symbol>
still only takes effect when the width or height of the window is changed,
not when the window is moved.
</para>
<para>
<!-- .LP -->
A bit-gravity of
-<function>ForgetGravity </function>
+<symbol>ForgetGravity</symbol>
indicates that the window's contents are always discarded after a size change,
even if a backing store or save under has been requested.
The window is tiled with its background
and zero or more
-<function>Expose </function>
+<symbol>Expose</symbol>
events are generated.
If no background is defined, the existing screen contents are not
altered.
Some X servers may also ignore the specified bit-gravity and
always generate
-<function>Expose</function>
+<symbol>Expose</symbol>
events.
</para>
<para>
@@ -849,20 +849,20 @@ events. The contents and borders of inferiors are not affected by their parent's
bit-gravity.
A server is permitted to ignore the specified bit-gravity and use
-<function>Forget</function>
+<symbol>Forget</symbol>
instead.
</para>
<para>
<!-- .LP -->
A win-gravity of
-<function>UnmapGravity </function>
+<symbol>UnmapGravity</symbol>
is like
-<function>NorthWestGravity</function>
+<symbol>NorthWestGravity</symbol>
(the window is not moved),
except the child is also
unmapped when the parent is resized,
and an
-<function>UnmapNotify </function>
+<symbol>UnmapNotify</symbol>
event is
generated.
</para>
@@ -875,7 +875,7 @@ generated. <para>
<!-- .LP -->
Some implementations of the X server may choose to maintain the contents of
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
windows.
If the X server maintains the contents of a window,
the off-screen saved pixels
@@ -883,39 +883,39 @@ are known as backing store. The backing store advises the X server on what to do
with the contents of a window.
The backing-store attribute can be set to
-<function>NotUseful </function>
+<symbol>NotUseful</symbol>
(default),
-<function>WhenMapped</function>,
+<symbol>WhenMapped</symbol>,
or
-<function>Always</function>.
+<symbol>Always</symbol>.
</para>
<para>
<!-- .LP -->
A backing-store attribute of
-<function>NotUseful </function>
+<symbol>NotUseful</symbol>
advises the X server that
maintaining contents is unnecessary,
although some X implementations may
still choose to maintain contents and, therefore, not generate
-<function>Expose</function>
+<symbol>Expose</symbol>
events.
A backing-store attribute of
-<function>WhenMapped </function>
+<symbol>WhenMapped</symbol>
advises the X server that maintaining contents of
obscured regions when the window is mapped would be beneficial.
In this case,
the server may generate an
-<function>Expose </function>
+<symbol>Expose</symbol>
event when the window is created.
A backing-store attribute of
-<function>Always </function>
+<symbol>Always</symbol>
advises the X server that maintaining contents even when
the window is unmapped would be beneficial.
Even if the window is larger than its parent,
this is a request to the X server to maintain complete contents,
not just the region within the parent window boundaries.
While the X server maintains the window's contents,
-<function>Expose </function>
+<symbol>Expose</symbol>
events normally are not generated,
but the X server may stop maintaining
contents at any time.
@@ -937,9 +937,9 @@ However, regions obscured by inferior windows are not included. <para>
<!-- .LP -->
Some server implementations may preserve contents of
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
windows under other
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
windows.
This is not the same as preserving the contents of a window for you.
You may get better visual
@@ -950,12 +950,12 @@ so the temporarily obscured applications do not have to repaint. <para>
<!-- .LP -->
You can set the save-under flag to
-<function>True</function>
+<symbol>True</symbol>
or
-<function>False </function>
+<symbol>False</symbol>
(default).
If save-under is
-<function>True</function>,
+<symbol>True</symbol>,
the X server is advised that, when this window is mapped,
saving the contents of windows it obscures would be beneficial.
</para>
@@ -969,7 +969,7 @@ saving the contents of windows it obscures would be beneficial. <!-- .LP -->
You can set backing planes to indicate (with bits set to 1)
which bit planes of an
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
window hold dynamic data that must be preserved in backing store
and during save unders.
The default value for the backing-planes attribute is all bits set to 1.
@@ -994,14 +994,14 @@ required to store your window. <para>
<!-- .LP -->
The event mask defines which events the client is interested in for this
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
or
-<function>InputOnly</function>
+<symbol>InputOnly</symbol>
window (or, for some event types, inferiors of this window).
The event mask is the bitwise inclusive OR of zero or more of the
valid event mask bits.
You can specify that no maskable events are reported by setting
-<function>NoEventMask </function>
+<symbol>NoEventMask</symbol>
(default).
</para>
<para>
@@ -1009,26 +1009,26 @@ You can specify that no maskable events are reported by setting The do-not-propagate-mask attribute
defines which events should not be propagated to
ancestor windows when no client has the event type selected in this
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
or
-<function>InputOnly</function>
+<symbol>InputOnly</symbol>
window.
The do-not-propagate-mask is the bitwise inclusive OR of zero or more
of the following masks:
-<function>KeyPress</function>,
-<function>KeyRelease</function>,
-<function>ButtonPress</function>,
-<function>ButtonRelease</function>,
-<function>PointerMotion</function>,
-<function>Button1Motion</function>,
-<function>Button2Motion</function>,
-<function>Button3Motion</function>,
-<function>Button4Motion</function>,
-<function>Button5Motion</function>,
+<symbol>KeyPress</symbol>,
+<symbol>KeyRelease</symbol>,
+<symbol>ButtonPress</symbol>,
+<symbol>ButtonRelease</symbol>,
+<symbol>PointerMotion</symbol>,
+<symbol>Button1Motion</symbol>,
+<symbol>Button2Motion</symbol>,
+<symbol>Button3Motion</symbol>,
+<symbol>Button4Motion</symbol>,
+<symbol>Button5Motion</symbol>,
and
-<function>ButtonMotion</function>.
+<symbol>ButtonMotion</symbol>.
You can specify that all events are propagated by setting
-<function>NoEventMask </function>
+<symbol>NoEventMask</symbol>
(default).
</para>
</sect2>
@@ -1045,9 +1045,9 @@ request. Pop-up windows, however, often need to be mapped without a window manager
getting in the way.
To control whether an
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
or
-<function>InputOnly</function>
+<symbol>InputOnly</symbol>
window is to ignore these structure control facilities,
use the override-redirect flag.
</para>
@@ -1055,12 +1055,12 @@ use the override-redirect flag. <!-- .LP -->
The override-redirect flag specifies whether map and configure requests
on this window should override a
-<function>SubstructureRedirectMask </function>
+<symbol>SubstructureRedirectMask</symbol>
on the parent.
You can set the override-redirect flag to
-<function>True</function>
+<symbol>True</symbol>
or
-<function>False </function>
+<symbol>False</symbol>
(default).
Window managers use this information to avoid tampering with pop-up windows
(see also chapter 14).
@@ -1075,33 +1075,33 @@ Window managers use this information to avoid tampering with pop-up windows <!-- .LP -->
The colormap attribute specifies which colormap best reflects the true
colors of the
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
window.
The colormap must have the same visual type as the window,
or a
-<function>BadMatch </function>
+<errorname>BadMatch</errorname>
error results.
X servers capable of supporting multiple
hardware colormaps can use this information,
and window managers can use it for calls to
<function>XInstallColormap</function>.
You can set the colormap attribute to a colormap or to
-<function>CopyFromParent</function>
+<symbol>CopyFromParent</symbol>
(default).
</para>
<para>
<!-- .LP -->
If you set the colormap to
-<function>CopyFromParent</function>,
+<symbol>CopyFromParent</symbol>,
the parent window's colormap is copied and used by its child.
However, the child window must have the same visual type as the parent,
or a
-<function>BadMatch </function>
+<errorname>BadMatch</errorname>
error results.
The parent window must not have a colormap of
-<function>None</function>,
+<symbol>None</symbol>,
or a
-<function>BadMatch </function>
+<errorname>BadMatch</errorname>
error results.
The colormap is copied by sharing the colormap object between the child
and parent, not by making a complete copy of the colormap contents.
@@ -1118,23 +1118,23 @@ not affect the child window. <!-- .LP -->
The cursor attribute specifies which cursor is to be used when the pointer is
in the
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
or
-<function>InputOnly</function>
+<symbol>InputOnly</symbol>
window.
You can set the cursor to a cursor or
-<function>None</function>
+<symbol>None</symbol>
(default).
</para>
<para>
<!-- .LP -->
If you set the cursor to
-<function>None</function>,
+<symbol>None</symbol>,
the parent's cursor is used when the
pointer is in the
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
or
-<function>InputOnly</function>
+<symbol>InputOnly</symbol>
window, and any change in the parent's cursor will cause an
immediate change in the displayed cursor.
By calling
@@ -1209,25 +1209,25 @@ see chapter 14 and the <emphasis remap='I'>Inter-Client Communication Convention <function>XCreateWindow</function>
is the more general function that allows you to set specific window attributes
when you create a window.
-<function>XCreateSimpleWindow </function>
+<function>XCreateSimpleWindow</function>
creates a window that inherits its attributes from its parent window.
</para>
<para>
<!-- .LP -->
<indexterm><primary>Window</primary><secondary>InputOnly</secondary></indexterm>
The X server acts as if
-<function>InputOnly </function>
+<symbol>InputOnly</symbol>
windows do not exist for
the purposes of graphics requests, exposure processing, and
-<function>VisibilityNotify </function>
+<symbol>VisibilityNotify</symbol>
events.
An
-<function>InputOnly </function>
+<symbol>InputOnly</symbol>
window cannot be used as a
drawable (that is, as a source or destination for graphics requests).
-<function>InputOnly</function>
+<symbol>InputOnly</symbol>
and
-<function>InputOutput </function>
+<symbol>InputOutput</symbol>
windows act identically in other respects (properties,
grabs, input control, and so on).
Extension packages can define other classes of windows.
@@ -1240,7 +1240,7 @@ To create an unmapped window and set its window attributes, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef>Window<function> XCreateWindow</function></funcdef>
+ <funcdef>Window <function>XCreateWindow</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> parent</parameter></paramdef>
<paramdef>intx,<parameter> y</parameter></paramdef>
@@ -1320,7 +1320,7 @@ and do not include the created window's borders Specify the width and height(Wh.
The dimensions must be nonzero,
or a
-<function>BadValue</function>
+<errorname>BadValue</errorname>
error results.
</para>
</listitem>
@@ -1343,7 +1343,7 @@ Specifies the width of the created window's border in pixels. <para>
Specifies the window's depth.
A depth of
-<function>CopyFromParent</function>
+<symbol>CopyFromParent</symbol>
means the depth is taken from the parent.
</para>
</listitem>
@@ -1356,12 +1356,12 @@ means the depth is taken from the parent. <para>
Specifies the created window's class.
You can pass
-<function>InputOutput</function>,
-<function>InputOnly</function>,
+<symbol>InputOutput</symbol>,
+<symbol>InputOnly</symbol>,
or
-<function>CopyFromParent</function>.
+<symbol>CopyFromParent</symbol>.
A class of
-<function>CopyFromParent</function>
+<symbol>CopyFromParent</symbol>
means the class
is taken from the parent.
</para>
@@ -1375,7 +1375,7 @@ is taken from the parent. <para>
Specifies the visual type.
A visual of
-<function>CopyFromParent </function>
+<symbol>CopyFromParent</symbol>
means the visual type is taken from the
parent.
</para>
@@ -1418,7 +1418,7 @@ The function creates an unmapped subwindow for a specified parent window,
returns the window ID of the created window,
and causes the X server to generate a
-<function>CreateNotify</function>
+<symbol>CreateNotify</symbol>
event.
The created window is placed on top in the stacking order
with respect to siblings.
@@ -1437,33 +1437,33 @@ the origin is inside the border at the inside, upper-left corner. <para>
<!-- .LP -->
The border_width for an
-<function>InputOnly</function>
+<symbol>InputOnly</symbol>
window must be zero, or a
-<function>BadMatch</function>
+<errorname>BadMatch</errorname>
error results.
For class
-<function>InputOutput</function>,
+<symbol>InputOutput</symbol>,
the visual type and depth must be a combination supported for the screen,
or a
-<function>BadMatch</function>
+<errorname>BadMatch</errorname>
error results.
The depth need not be the same as the parent,
but the parent must not be a window of class
-<function>InputOnly</function>,
+<symbol>InputOnly</symbol>,
or a
-<function>BadMatch</function>
+<errorname>BadMatch</errorname>
error results.
For an
-<function>InputOnly</function>
+<symbol>InputOnly</symbol>
window,
the depth must be zero, and the visual must be one supported by the screen.
If either condition is not met,
a
-<function>BadMatch</function>
+<errorname>BadMatch</errorname>
error results.
The parent window, however, may have any depth and class.
If you specify any invalid window attribute for a window, a
-<function>BadMatch</function>
+<errorname>BadMatch</errorname>
error results.
</para>
<para>
@@ -1484,28 +1484,28 @@ ancestors are mapped and it is not obscured by any of its ancestors. <!-- .LP -->
<function>XCreateWindow</function>
can generate
-<function>BadAlloc</function>,
-<function>BadColor</function>,
-<function>BadCursor</function>,
-<function>BadMatch</function>,
-<function>BadPixmap</function>,
-<function>BadValue</function>,
+<errorname>BadAlloc</errorname>,
+<errorname>BadColor</errorname>,
+<errorname>BadCursor</errorname>,
+<errorname>BadMatch</errorname>,
+<errorname>BadPixmap</errorname>,
+<errorname>BadValue</errorname>,
and
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
errors.
</para>
<para>
<!-- .LP -->
<!-- .sp -->
To create an unmapped
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
subwindow of a given parent window, use
<function>XCreateSimpleWindow</function>.
<indexterm significance="preferred"><primary>XCreateSimpleWindow</primary></indexterm>
<!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef>Window<function> XCreateSimpleWindow</function></funcdef>
+ <funcdef>Window <function>XCreateSimpleWindow</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> parent</parameter></paramdef>
<paramdef>intx,<parameter> y</parameter></paramdef>
@@ -1582,7 +1582,7 @@ and do not include the created window's borders Specify the width and height(Wh.
The dimensions must be nonzero,
or a
-<function>BadValue</function>
+<errorname>BadValue</errorname>
error results.
</para>
</listitem>
@@ -1626,18 +1626,18 @@ Specifies the background pixel value of the window. The
<function>XCreateSimpleWindow</function>
function creates an unmapped
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
subwindow for a specified parent window, returns the
window ID of the created window, and causes the X server to generate a
-<function>CreateNotify</function>
+<symbol>CreateNotify</symbol>
event.
The created window is placed on top in the stacking order with respect to
siblings.
Any part of the window that extends outside its parent window is clipped.
The border_width for an
-<function>InputOnly</function>
+<symbol>InputOnly</symbol>
window must be zero, or a
-<function>BadMatch</function>
+<errorname>BadMatch</errorname>
error results.
<function>XCreateSimpleWindow</function>
inherits its depth, class, and visual from its parent.
@@ -1648,11 +1648,11 @@ have their default values. <!-- .LP -->
<function>XCreateSimpleWindow</function>
can generate
-<function>BadAlloc</function>,
-<function>BadMatch</function>,
-<function>BadValue</function>,
+<errorname>BadAlloc</errorname>,
+<errorname>BadMatch</errorname>,
+<errorname>BadValue</errorname>,
and
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
errors.
</para>
</sect1>
@@ -1675,7 +1675,7 @@ To destroy a window and all of its subwindows, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XDestroyWindow</function></funcdef>
+ <funcdef><function>XDestroyWindow</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
</funcprototype>
@@ -1711,29 +1711,29 @@ The <function>XDestroyWindow</function>
function destroys the specified window as well as all of its subwindows and causes
the X server to generate a
-<function>DestroyNotify</function>
+<symbol>DestroyNotify</symbol>
event for each window.
The window should never be referenced again.
If the window specified by the w argument is mapped,
it is unmapped automatically.
The ordering of the
-<function>DestroyNotify</function>
+<symbol>DestroyNotify</symbol>
events is such that for any given window being destroyed,
-<function>DestroyNotify</function>
+<symbol>DestroyNotify</symbol>
is generated on any inferiors of the window before being generated on
the window itself.
The ordering among siblings and across subhierarchies is not otherwise
constrained.
If the window you specified is a root window, no windows are destroyed.
Destroying a mapped window will generate
-<function>Expose </function>
+<symbol>Expose</symbol>
events on other windows that were obscured by the window being destroyed.
</para>
<para>
<!-- .LP -->
<function>XDestroyWindow</function>
can generate a
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
error.
</para>
<para>
@@ -1745,7 +1745,7 @@ To destroy all subwindows of a specified window, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XDestroySubwindows</function></funcdef>
+ <funcdef><function>XDestroySubwindows</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
</funcprototype>
@@ -1782,13 +1782,13 @@ The function destroys all inferior windows of the specified window,
in bottom-to-top stacking order.
It causes the X server to generate a
-<function>DestroyNotify</function>
+<symbol>DestroyNotify</symbol>
event for each window.
If any mapped
subwindows were actually destroyed,
<function>XDestroySubwindows</function>
causes the X server to generate
-<function>Expose </function>
+<symbol>Expose</symbol>
events on the specified window.
This is much more efficient than deleting many windows
one at a time because much of the work need be performed only once for all
@@ -1799,7 +1799,7 @@ The subwindows should never be referenced again. <!-- .LP -->
<function>XDestroySubwindows</function>
can generate a
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
error.
</para>
</sect1>
@@ -1834,11 +1834,11 @@ It is entirely clipped by an ancestor. </itemizedlist>
<para>
<!-- .LP -->
-<function>Expose </function>
+<symbol>Expose</symbol>
events are generated for the window when part or all of
it becomes visible on the screen.
A client receives the
-<function>Expose </function>
+<symbol>Expose</symbol>
events only if it has asked for them.
Windows retain their position in the stacking order when they are unmapped.
</para>
@@ -1846,15 +1846,15 @@ Windows retain their position in the stacking order when they are unmapped. <!-- .LP -->
A window manager may want to control the placement of subwindows.
If
-<function>SubstructureRedirectMask </function>
+<symbol>SubstructureRedirectMask</symbol>
has been selected by a window manager
on a parent window (usually a root window),
a map request initiated by other clients on a child window is not performed,
and the window manager is sent a
-<function>MapRequest </function>
+<symbol>MapRequest</symbol>
event.
However, if the override-redirect flag on the child had been set to
-<function>True</function>
+<symbol>True</symbol>
(usually only on pop-up menus),
the map request is performed.
</para>
@@ -1867,16 +1867,16 @@ reparent the child into a frame first. For further information,
see sections 3.2.8 and 10.10.
Only a single client at a time can select for
-<function>SubstructureRedirectMask</function>.
+<symbol>SubstructureRedirectMask</symbol>.
</para>
<para>
<!-- .LP -->
Similarly, a single client can select for
-<function>ResizeRedirectMask </function>
+<symbol>ResizeRedirectMask</symbol>
on a parent window.
Then, any attempt to resize the window by another client is suppressed, and
the client receives a
-<function>ResizeRequest </function>
+<symbol>ResizeRequest</symbol>
event.
</para>
<para>
@@ -1888,7 +1888,7 @@ To map a given window, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XMapWindow</function></funcdef>
+ <funcdef><function>XMapWindow</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
</funcprototype>
@@ -1937,16 +1937,16 @@ This function has no effect if the window is already mapped. <para>
<!-- .LP -->
If the override-redirect of the window is
-<function>False </function>
+<symbol>False</symbol>
and if some other client has selected
-<function>SubstructureRedirectMask</function>
+<symbol>SubstructureRedirectMask</symbol>
on the parent window, then the X server generates a
-<function>MapRequest</function>
+<symbol>MapRequest</symbol>
event, and the
<function>XMapWindow</function>
function does not map the window.
Otherwise, the window is mapped, and the X server generates a
-<function>MapNotify</function>
+<symbol>MapNotify</symbol>
event.
</para>
<para>
@@ -1956,10 +1956,10 @@ the X server tiles the window with its background. If the window's background is undefined,
the existing screen contents are not
altered, and the X server generates zero or more
-<function>Expose</function>
+<symbol>Expose</symbol>
events.
If backing-store was maintained while the window was unmapped, no
-<function>Expose</function>
+<symbol>Expose</symbol>
events
are generated.
If backing-store will now be maintained,
@@ -1971,29 +1971,29 @@ Similar tiling and exposure take place for any newly viewable inferiors. <!-- .LP -->
<indexterm><primary>XMapWindow</primary></indexterm>
If the window is an
-<function>InputOutput </function>
+<symbol>InputOutput</symbol>
window,
<function>XMapWindow</function>
generates
-<function>Expose </function>
+<symbol>Expose</symbol>
events on each
-<function>InputOutput</function>
+<symbol>InputOutput</symbol>
window that it causes to be displayed.
If the client maps and paints the window
and if the client begins processing events,
the window is painted twice.
To avoid this,
first ask for
-<function>Expose </function>
+<symbol>Expose</symbol>
events and then map the window,
so the client processes input events as usual.
The event list will include
-<function>Expose </function>
+<symbol>Expose</symbol>
for each
window that has appeared on the screen.
The client's normal response to
an
-<function>Expose </function>
+<symbol>Expose</symbol>
event should be to repaint the window.
This method usually leads to simpler programs and to proper interaction
with window managers.
@@ -2002,7 +2002,7 @@ with window managers. <!-- .LP -->
<function>XMapWindow</function>
can generate a
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
error.
</para>
<para>
@@ -2014,7 +2014,7 @@ To map and raise a window, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XMapRaised</function></funcdef>
+ <funcdef><function>XMapRaised</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
</funcprototype>
@@ -2062,7 +2062,7 @@ see <!-- .LP -->
<function>XMapRaised</function>
can generate multiple
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
errors.
</para>
<para>
@@ -2074,7 +2074,7 @@ To map all subwindows for a specified window, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XMapSubwindows</function></funcdef>
+ <funcdef><function>XMapSubwindows</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
</funcprototype>
@@ -2112,7 +2112,7 @@ The function maps all subwindows for a specified window in top-to-bottom stacking
order.
The X server generates
-<function>Expose</function>
+<symbol>Expose</symbol>
events on each newly displayed window.
This may be much more efficient than mapping many windows
one at a time because the server needs to perform much of the work
@@ -2122,7 +2122,7 @@ only once, for all of the windows, rather than for each window. <!-- .LP -->
<function>XMapSubwindows</function>
can generate a
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
error.
</para>
</sect1>
@@ -2144,7 +2144,7 @@ To unmap a window, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XUnmapWindow</function></funcdef>
+ <funcdef><function>XUnmapWindow</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
</funcprototype>
@@ -2179,12 +2179,12 @@ Specifies the window. The
<function>XUnmapWindow</function>
function unmaps the specified window and causes the X server to generate an
-<function>UnmapNotify</function>
+<symbol>UnmapNotify</symbol>
<indexterm><primary>UnmapNotify Event</primary></indexterm>
<indexterm><primary>XUnmapWindow</primary></indexterm>
event.
If the specified window is already unmapped,
-<function>XUnmapWindow </function>
+<function>XUnmapWindow</function>
has no effect.
Normal exposure processing on formerly obscured windows is performed.
Any child window will no longer be visible until another map call is
@@ -2192,14 +2192,14 @@ made on the parent. In other words, the subwindows are still mapped but are not visible
until the parent is mapped.
Unmapping a window will generate
-<function>Expose </function>
+<symbol>Expose</symbol>
events on windows that were formerly obscured by it.
</para>
<para>
<!-- .LP -->
<function>XUnmapWindow</function>
can generate a
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
error.
</para>
<para>
@@ -2211,7 +2211,7 @@ To unmap all subwindows for a specified window, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XUnmapSubwindows</function></funcdef>
+ <funcdef><function>XUnmapSubwindows</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
</funcprototype>
@@ -2248,9 +2248,9 @@ The function unmaps all subwindows for the specified window in bottom-to-top
stacking order.
It causes the X server to generate an
-<function>UnmapNotify</function>
+<symbol>UnmapNotify</symbol>
event on each subwindow and
-<function>Expose </function>
+<symbol>Expose</symbol>
events on formerly obscured windows.
<indexterm><primary>UnmapNotify Event</primary></indexterm>
Using this function is much more efficient than unmapping multiple windows
@@ -2261,7 +2261,7 @@ only once, for all of the windows, rather than for each window. <!-- .LP -->
<function>XUnmapSubwindows</function>
can generate a
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
error.
</para>
</sect1>
@@ -2280,11 +2280,11 @@ move a window, resize a window, move and resize a window, or change a window's border width.
To change one of these parameters,
set the appropriate member of the
-<function>XWindowChanges</function>
+<structname>XWindowChanges</structname>
structure and OR in the corresponding value mask in subsequent calls to
<function>XConfigureWindow</function>.
The symbols for the value mask bits and the
-<function>XWindowChanges</function>
+<structname>XWindowChanges</structname>
structure are:
<!-- .sM -->
</para>
@@ -2323,7 +2323,7 @@ which are relative to the parent's origin and indicate the position of the upper-left outer corner of the window.
The width and height members are used to set the inside size of the window,
not including the border, and must be nonzero, or a
-<function>BadValue</function>
+<errorname>BadValue</errorname>
error results.
Attempts to configure a root window have no effect.
</para>
@@ -2333,9 +2333,9 @@ The border_width member is used to set the width of the border in pixels. Note that setting just the border width leaves the outer-left corner of the window
in a fixed position but moves the absolute position of the window's origin.
If you attempt to set the border-width attribute of an
-<function>InputOnly</function>
+<symbol>InputOnly</symbol>
window nonzero, a
-<function>BadMatch</function>
+<errorname>BadMatch</errorname>
error results.
</para>
<para>
@@ -2343,49 +2343,49 @@ error results. The sibling member is used to set the sibling window for stacking operations.
The stack_mode member is used to set how the window is to be restacked
and can be set to
-<function>Above</function>,
-<function>Below</function>,
-<function>TopIf</function>,
-<function>BottomIf</function>,
+<symbol>Above</symbol>,
+<symbol>Below</symbol>,
+<symbol>TopIf</symbol>,
+<symbol>BottomIf</symbol>,
or
-<function>Opposite</function>.
+<symbol>Opposite</symbol>.
</para>
<para>
<!-- .LP -->
If the override-redirect flag of the window is
-<function>False </function>
+<symbol>False</symbol>
and if some other client has selected
-<function>SubstructureRedirectMask</function>
+<symbol>SubstructureRedirectMask</symbol>
on the parent, the X server generates a
-<function>ConfigureRequest</function>
+<symbol>ConfigureRequest</symbol>
event, and no further processing is performed.
Otherwise,
if some other client has selected
-<function>ResizeRedirectMask </function>
+<symbol>ResizeRedirectMask</symbol>
on the window and the inside
width or height of the window is being changed,
a
-<function>ResizeRequest</function>
+<symbol>ResizeRequest</symbol>
event is generated, and the current inside width and height are
used instead.
Note that the override-redirect flag of the window has no effect
on
-<function>ResizeRedirectMask </function>
+<symbol>ResizeRedirectMask</symbol>
and that
-<function>SubstructureRedirectMask</function>
+<symbol>SubstructureRedirectMask</symbol>
on the parent has precedence over
-<function>ResizeRedirectMask </function>
+<symbol>ResizeRedirectMask</symbol>
on the window.
</para>
<para>
<!-- .LP -->
When the geometry of the window is changed as specified,
the window is restacked among siblings, and a
-<function>ConfigureNotify </function>
+<symbol>ConfigureNotify</symbol>
event is generated if the state of the window actually changes.
-<function>GravityNotify</function>
+<symbol>GravityNotify</symbol>
events are generated after
-<function>ConfigureNotify </function>
+<symbol>ConfigureNotify</symbol>
events.
If the inside width or height of the window has actually changed,
children of the window are affected as specified.
@@ -2409,15 +2409,15 @@ and any regions where window contents are lost. <para>
<!-- .LP -->
The restack check (specifically, the computation for
-<function>BottomIf</function>,
-<function>TopIf</function>,
+<symbol>BottomIf</symbol>,
+<symbol>TopIf</symbol>,
and
-<function>Opposite</function>)
+<symbol>Opposite</symbol>)
is performed with respect to the window's final size and position (as
controlled by the other arguments of the request), not its initial position.
If a sibling is specified without a stack_mode,
a
-<function>BadMatch</function>
+<errorname>BadMatch</errorname>
error results.
</para>
<para>
@@ -2431,23 +2431,23 @@ the window is restacked as follows: <colspec colname='c2'/>
<tbody>
<row>
- <entry><function>Above</function></entry>
+ <entry><symbol>Above</symbol></entry>
<entry>The window is placed just above the sibling.</entry>
</row>
<row>
- <entry><function>Below</function></entry>
+ <entry><symbol>Below</symbol></entry>
<entry>The window is placed just below the sibling.</entry>
</row>
<row>
- <entry><function>TopIf</function></entry>
+ <entry><symbol>TopIf</symbol></entry>
<entry>If the sibling occludes the window, the window is placed at the top of the stack.</entry>
</row>
<row>
- <entry><function>BottomIf</function></entry>
+ <entry><symbol>BottomIf</symbol></entry>
<entry>If the window occludes the sibling, the window is placed at the bottom of the stack.</entry>
</row>
<row>
- <entry><function>Opposite</function></entry>
+ <entry><symbol>Opposite</symbol></entry>
<entry>
If the sibling occludes the window, the window is placed at the top of the stack.
If the window occludes the sibling,
@@ -2470,15 +2470,15 @@ the window is restacked as follows: <colspec colname='c2'/>
<tbody>
<row>
- <entry><function>Above</function></entry>
+ <entry><symbol>Above</symbol></entry>
<entry>The window is placed at the top of the stack.</entry>
</row>
<row>
- <entry><function>Below</function></entry>
+ <entry><symbol>Below</symbol></entry>
<entry>The window is placed at the bottom of the stack.</entry>
</row>
<row>
- <entry><function>TopIf</function></entry>
+ <entry><symbol>TopIf</symbol></entry>
<entry>
If any sibling occludes the window, the window is placed at
the top of the stack.
@@ -2491,7 +2491,7 @@ the bottom of the stack. </entry>
</row>
<row>
- <entry><function>Opposite</function></entry>
+ <entry><symbol>Opposite</symbol></entry>
<entry>
If any sibling occludes the window, the window
is placed at the top of the stack.
@@ -2516,7 +2516,7 @@ To configure a window's size, location, stacking, or border, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XConfigureWindow</function></funcdef>
+ <funcdef><function>XConfigureWindow</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
<paramdef>unsignedint<parameter> value_mask</parameter></paramdef>
@@ -2565,7 +2565,7 @@ This mask is the bitwise inclusive OR of the valid configure window values bits. <listitem>
<para>
Specifies the
-<function>XWindowChanges </function>
+<structname>XWindowChanges</structname>
structure.
</para>
</listitem>
@@ -2578,7 +2578,7 @@ structure. The
<function>XConfigureWindow</function>
function uses the values specified in the
-<function>XWindowChanges</function>
+<structname>XWindowChanges</structname>
structure to reconfigure a window's size, position, border, and stacking order.
Values not specified are taken from the existing geometry of the window.
</para>
@@ -2587,13 +2587,13 @@ Values not specified are taken from the existing geometry of the window. If a sibling is specified without a stack_mode or if the window
is not actually a sibling,
a
-<function>BadMatch</function>
+<errorname>BadMatch</errorname>
error results.
Note that the computations for
-<function>BottomIf</function>,
-<function>TopIf</function>,
+<symbol>BottomIf</symbol>,
+<symbol>TopIf</symbol>,
and
-<function>Opposite</function>
+<symbol>Opposite</symbol>
are performed with respect to the window's final geometry (as controlled by the
other arguments passed to
<function>XConfigureWindow</function>),
@@ -2607,10 +2607,10 @@ changed to reflect the current screen contents <!-- .LP -->
<function>XConfigureWindow</function>
can generate
-<function>BadMatch</function>,
-<function>BadValue</function>,
+<errorname>BadMatch</errorname>,
+<errorname>BadValue</errorname>,
and
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
errors.
</para>
<para>
@@ -2622,7 +2622,7 @@ To move a window without changing its size, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XMoveWindow</function></funcdef>
+ <funcdef><function>XMoveWindow</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
<paramdef>intx,<parameter> y</parameter></paramdef>
@@ -2689,21 +2689,21 @@ depending on if the window is obscured by nonchildren and if no backing store exists.
If the contents of the window are lost,
the X server generates
-<function>Expose </function>
+<symbol>Expose</symbol>
events.
Moving a mapped window generates
-<function>Expose </function>
+<symbol>Expose</symbol>
events on any formerly obscured windows.
</para>
<para>
<!-- .LP -->
If the override-redirect flag of the window is
-<function>False </function>
+<symbol>False</symbol>
and some
other client has selected
-<function>SubstructureRedirectMask </function>
+<symbol>SubstructureRedirectMask</symbol>
on the parent, the X server generates a
-<function>ConfigureRequest </function>
+<symbol>ConfigureRequest</symbol>
event, and no further processing is
performed.
Otherwise, the window is moved.
@@ -2712,7 +2712,7 @@ Otherwise, the window is moved. <!-- .LP -->
<function>XMoveWindow</function>
can generate a
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
error.
</para>
<para>
@@ -2724,7 +2724,7 @@ To change a window's size without changing the upper-left coordinate, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XResizeWindow</function></funcdef>
+ <funcdef><function>XResizeWindow</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
<paramdef>unsignedintwidth,<parameter> height</parameter></paramdef>
@@ -2787,35 +2787,35 @@ its borders. This function does not change the window's upper-left coordinate or
the origin and does not restack the window.
Changing the size of a mapped window may lose its contents and generate
-<function>Expose </function>
+<symbol>Expose</symbol>
events.
If a mapped window is made smaller,
changing its size generates
-<function>Expose </function>
+<symbol>Expose</symbol>
events on windows that the mapped window formerly obscured.
</para>
<para>
<!-- .LP -->
If the override-redirect flag of the window is
-<function>False </function>
+<symbol>False</symbol>
and some
other client has selected
-<function>SubstructureRedirectMask </function>
+<symbol>SubstructureRedirectMask</symbol>
on the parent, the X server generates a
-<function>ConfigureRequest </function>
+<symbol>ConfigureRequest</symbol>
event, and no further processing is performed.
If either width or height is zero,
a
-<function>BadValue</function>
+<errorname>BadValue</errorname>
error results.
</para>
<para>
<!-- .LP -->
<function>XResizeWindow</function>
can generate
-<function>BadValue</function>
+<errorname>BadValue</errorname>
and
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
errors.
</para>
<para>
@@ -2827,7 +2827,7 @@ To change the size and location of a window, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XMoveResizeWindow</function></funcdef>
+ <funcdef><function>XMoveResizeWindow</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
<paramdef>intx,<parameter> y</parameter></paramdef>
@@ -2911,22 +2911,22 @@ The function changes the size and location of the specified window
without raising it.
Moving and resizing a mapped window may generate an
-<function>Expose </function>
+<symbol>Expose</symbol>
event on the window.
Depending on the new size and location parameters,
moving and resizing a window may generate
-<function>Expose </function>
+<symbol>Expose</symbol>
events on windows that the window formerly obscured.
</para>
<para>
<!-- .LP -->
If the override-redirect flag of the window is
-<function>False </function>
+<symbol>False</symbol>
and some
other client has selected
-<function>SubstructureRedirectMask </function>
+<symbol>SubstructureRedirectMask</symbol>
on the parent, the X server generates a
-<function>ConfigureRequest </function>
+<symbol>ConfigureRequest</symbol>
event, and no further processing is performed.
Otherwise, the window size and location are changed.
</para>
@@ -2934,9 +2934,9 @@ Otherwise, the window size and location are changed. <!-- .LP -->
<function>XMoveResizeWindow</function>
can generate
-<function>BadValue </function>
+<errorname>BadValue</errorname>
and
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
errors.
</para>
<para>
@@ -2948,7 +2948,7 @@ To change the border width of a given window, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XSetWindowBorderWidth</function></funcdef>
+ <funcdef><function>XSetWindowBorderWidth</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
<paramdef>unsignedint<parameter> width</parameter></paramdef>
@@ -2999,7 +2999,7 @@ function sets the specified window's border width to the specified width. <!-- .LP -->
<function>XSetWindowBorderWidth</function>
can generate a
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
error.
</para>
</sect1>
@@ -3025,7 +3025,7 @@ To raise a window so that no sibling window obscures it, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XRaiseWindow</function></funcdef>
+ <funcdef><function>XRaiseWindow</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
</funcprototype>
@@ -3067,18 +3067,18 @@ on a desk, then raising a window is analogous to moving the sheet to the top of
the stack but leaving its x and y location on the desk constant.
Raising a mapped window may generate
-<function>Expose</function>
+<symbol>Expose</symbol>
events for the window and any mapped subwindows that were formerly obscured.
</para>
<para>
<!-- .LP -->
If the override-redirect attribute of the window is
-<function>False </function>
+<symbol>False</symbol>
and some
other client has selected
-<function>SubstructureRedirectMask </function>
+<symbol>SubstructureRedirectMask</symbol>
on the parent, the X server generates a
-<function>ConfigureRequest </function>
+<symbol>ConfigureRequest</symbol>
event, and no processing is performed.
Otherwise, the window is raised.
</para>
@@ -3086,7 +3086,7 @@ Otherwise, the window is raised. <!-- .LP -->
<function>XRaiseWindow</function>
can generate a
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
error.
</para>
<para>
@@ -3098,7 +3098,7 @@ To lower a window so that it does not obscure any sibling windows, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XLowerWindow</function></funcdef>
+ <funcdef><function>XLowerWindow</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
</funcprototype>
@@ -3140,18 +3140,18 @@ stacked on a desk, then lowering a window is analogous to moving the sheet to the bottom of the stack but leaving its x and y location on
the desk constant.
Lowering a mapped window will generate
-<function>Expose </function>
+<symbol>Expose</symbol>
events on any windows it formerly obscured.
</para>
<para>
<!-- .LP -->
If the override-redirect attribute of the window is
-<function>False </function>
+<symbol>False</symbol>
and some
other client has selected
-<function>SubstructureRedirectMask </function>
+<symbol>SubstructureRedirectMask</symbol>
on the parent, the X server generates a
-<function>ConfigureRequest </function>
+<symbol>ConfigureRequest</symbol>
event, and no processing is performed.
Otherwise, the window is lowered to the bottom of the
stack.
@@ -3160,7 +3160,7 @@ stack. <!-- .LP -->
<function>XLowerWindow</function>
can generate a
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
error.
</para>
<para>
@@ -3172,7 +3172,7 @@ To circulate a subwindow up or down, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XCirculateSubwindows</function></funcdef>
+ <funcdef><function>XCirculateSubwindows</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
<paramdef>int<parameter> direction</parameter></paramdef>
@@ -3209,9 +3209,9 @@ Specifies the window. Specifies the direction (up or down) that you want to circulate
the window.
You can pass
-<function>RaiseLowest</function>
+<symbol>RaiseLowest</symbol>
or
-<function>LowerHighest</function>.
+<symbol>LowerHighest</symbol>.
</para>
</listitem>
</varlistentry>
@@ -3225,33 +3225,33 @@ The function circulates children of the specified window in the specified
direction.
If you specify
-<function>RaiseLowest</function>,
+<symbol>RaiseLowest</symbol>,
<function>XCirculateSubwindows</function>
raises the lowest mapped child (if any) that is occluded
by another child to the top of the stack.
If you specify
-<function>LowerHighest</function>,
+<symbol>LowerHighest</symbol>,
<function>XCirculateSubwindows</function>
lowers the highest mapped child (if any) that occludes another child
to the bottom of the stack.
Exposure processing is then performed on formerly obscured windows.
If some other client has selected
-<function>SubstructureRedirectMask </function>
+<symbol>SubstructureRedirectMask</symbol>
on the window, the X server generates a
-<function>CirculateRequest </function>
+<symbol>CirculateRequest</symbol>
event, and no further processing is performed.
If a child is actually restacked,
the X server generates a
-<function>CirculateNotify</function>
+<symbol>CirculateNotify</symbol>
event.
</para>
<para>
<!-- .LP -->
<function>XCirculateSubwindows</function>
can generate
-<function>BadValue</function>
+<errorname>BadValue</errorname>
and
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
errors.
</para>
<para>
@@ -3264,7 +3264,7 @@ occluded by another child, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XCirculateSubwindowsUp</function></funcdef>
+ <funcdef><function>XCirculateSubwindowsUp</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
</funcprototype>
@@ -3306,14 +3306,14 @@ Completely unobscured children are not affected. This is a convenience function equivalent to
<function>XCirculateSubwindows</function>
with
-<function>RaiseLowest</function>
+<symbol>RaiseLowest</symbol>
specified.
</para>
<para>
<!-- .LP -->
<function>XCirculateSubwindowsUp</function>
can generate a
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
error.
</para>
<para>
@@ -3326,7 +3326,7 @@ completely occludes another child, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XCirculateSubwindowsDown</function></funcdef>
+ <funcdef><function>XCirculateSubwindowsDown</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
</funcprototype>
@@ -3366,14 +3366,14 @@ Completely unobscured children are not affected. This is a convenience function equivalent to
<function>XCirculateSubwindows</function>
with
-<function>LowerHighest</function>
+<symbol>LowerHighest</symbol>
specified.
</para>
<para>
<!-- .LP -->
<function>XCirculateSubwindowsDown</function>
can generate a
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
error.
</para>
<para>
@@ -3385,7 +3385,7 @@ To restack a set of windows from top to bottom, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XRestackWindows</function></funcdef>
+ <funcdef><function>XRestackWindows</function></funcdef>
<paramdef>XRestackWindows\^(\^display,windows,<parameter> \^nwindows)</parameter></paramdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> windows[]</parameter></paramdef>
@@ -3439,18 +3439,18 @@ in the order of the array. The stacking order of the other windows is not affected.
For each window in the window array that is not a child of the specified window,
a
-<function>BadMatch</function>
+<errorname>BadMatch</errorname>
error results.
</para>
<para>
<!-- .LP -->
If the override-redirect attribute of a window is
-<function>False </function>
+<symbol>False</symbol>
and some
other client has selected
-<function>SubstructureRedirectMask </function>
+<symbol>SubstructureRedirectMask</symbol>
on the parent, the X server generates
-<function>ConfigureRequest </function>
+<symbol>ConfigureRequest</symbol>
events for each window whose override-redirect flag is not set,
and no further processing is performed.
Otherwise, the windows will be restacked in top-to-bottom order.
@@ -3459,7 +3459,7 @@ Otherwise, the windows will be restacked in top-to-bottom order. <!-- .LP -->
<function>XRestackWindows</function>
can generate a
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
error.
</para>
</sect1>
@@ -3477,7 +3477,7 @@ Xlib provides functions that you can use to set window attributes. <function>XChangeWindowAttributes</function>
is the more general function that allows you to set one or more window
attributes provided by the
-<function>XSetWindowAttributes</function>
+<structname>XSetWindowAttributes</structname>
structure.
The other functions described in this section allow you to set one specific
window attribute, such as a window's background.
@@ -3491,7 +3491,7 @@ To change one or more attributes for a given window, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XChangeWindowAttributes</function></funcdef>
+ <funcdef><function>XChangeWindowAttributes</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
<paramdef>unsignedlong<parameter> valuemask</parameter></paramdef>
@@ -3569,7 +3569,7 @@ Depending on the valuemask, the
<function>XChangeWindowAttributes</function>
function uses the window attributes in the
-<function>XSetWindowAttributes</function>
+<structname>XSetWindowAttributes</structname>
structure to change the specified window attributes.
Changing the background does not cause the window contents to be
changed.
@@ -3578,31 +3578,31 @@ To repaint the window and its background, use Setting the border or changing the background such that the
border tile origin changes causes the border to be repainted.
Changing the background of a root window to
-<function>None </function>
+<symbol>None</symbol>
or
-<function>ParentRelative</function>
+<symbol>ParentRelative</symbol>
restores the default background pixmap.
Changing the border of a root window to
-<function>CopyFromParent</function>
+<symbol>CopyFromParent</symbol>
restores the default border pixmap.
Changing the win-gravity does not affect the current position of the
window.
Changing the backing-store of an obscured window to
-<function>WhenMapped </function>
+<symbol>WhenMapped</symbol>
or
-<function>Always</function>,
+<symbol>Always</symbol>,
or changing the backing-planes, backing-pixel, or
save-under of a mapped window may have no immediate effect.
Changing the colormap of a window (that is, defining a new map, not
changing the contents of the existing map) generates a
-<function>ColormapNotify</function>
+<symbol>ColormapNotify</symbol>
event.
Changing the colormap of a visible window may have no
immediate effect on the screen because the map may not be installed
(see
<function>XInstallColormap</function>).
Changing the cursor of a root window to
-<function>None </function>
+<symbol>None</symbol>
restores the default
cursor.
Whenever possible, you are encouraged to share colormaps.
@@ -3614,14 +3614,14 @@ Their event masks are maintained separately. When an event is generated,
it is reported to all interested clients.
However, only one client at a time can select for
-<function>SubstructureRedirectMask</function>,
-<function>ResizeRedirectMask</function>,
+<symbol>SubstructureRedirectMask</symbol>,
+<symbol>ResizeRedirectMask</symbol>,
and
-<function>ButtonPressMask</function>.
+<symbol>ButtonPressMask</symbol>.
If a client attempts to select any of these event masks
and some other client has already selected one,
a
-<function>BadAccess</function>
+<errorname>BadAccess</errorname>
error results.
There is only one do-not-propagate-mask for a window,
not one per client.
@@ -3630,14 +3630,14 @@ not one per client. <!-- .LP -->
<function>XChangeWindowAttributes</function>
can generate
-<function>BadAccess</function>,
-<function>BadColor</function>,
-<function>BadCursor</function>,
-<function>BadMatch</function>,
-<function>BadPixmap</function>,
-<function>BadValue</function>,
+<errorname>BadAccess</errorname>,
+<errorname>BadColor</errorname>,
+<errorname>BadCursor</errorname>,
+<errorname>BadMatch</errorname>,
+<errorname>BadPixmap</errorname>,
+<errorname>BadValue</errorname>,
and
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
errors.
</para>
<para>
@@ -3649,7 +3649,7 @@ To set the background of a window to a given pixel, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XSetWindowBackground</function></funcdef>
+ <funcdef><function>XSetWindowBackground</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
<paramdef>unsignedlong<parameter> background_pixel</parameter></paramdef>
@@ -3699,18 +3699,18 @@ Changing the background does not cause the window contents to be changed. <function>XSetWindowBackground</function>
uses a pixmap of undefined size filled with the pixel value you passed.
If you try to change the background of an
-<function>InputOnly</function>
+<symbol>InputOnly</symbol>
window, a
-<function>BadMatch</function>
+<errorname>BadMatch</errorname>
error results.
</para>
<para>
<!-- .LP -->
<function>XSetWindowBackground</function>
can generate
-<function>BadMatch</function>
+<errorname>BadMatch</errorname>
and
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
errors.
</para>
<para>
@@ -3726,7 +3726,7 @@ To set the background of a window to a given pixmap, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XSetWindowBackgroundPixmap</function></funcdef>
+ <funcdef><function>XSetWindowBackgroundPixmap</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
<paramdef>Pixmap<parameter> background_pixmap</parameter></paramdef>
@@ -3761,9 +3761,9 @@ Specifies the window. <listitem>
<para>
Specifies the background pixmap,
-<function>ParentRelative</function>,
+<symbol>ParentRelative</symbol>,
or
-<function>None</function>.
+<symbol>None</symbol>.
</para>
</listitem>
</varlistentry>
@@ -3780,27 +3780,27 @@ function sets the background pixmap of the window to the specified pixmap. The background pixmap can immediately be freed if no further explicit
references to it are to be made.
If
-<function>ParentRelative</function>
+<symbol>ParentRelative</symbol>
is specified,
the background pixmap of the window's parent is used,
or on the root window, the default background is restored.
If you try to change the background of an
-<function>InputOnly</function>
+<symbol>InputOnly</symbol>
window, a
-<function>BadMatch</function>
+<errorname>BadMatch</errorname>
error results.
If the background is set to
-<function>None</function>,
+<symbol>None</symbol>,
the window has no defined background.
</para>
<para>
<!-- .LP -->
<function>XSetWindowBackgroundPixmap</function>
can generate
-<function>BadMatch</function>,
-<function>BadPixmap</function>,
+<errorname>BadMatch</errorname>,
+<errorname>BadPixmap</errorname>,
and
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
errors.
<!-- .NT Note -->
<function>XSetWindowBackground</function>
@@ -3818,7 +3818,7 @@ To change and repaint a window's border to a given pixel, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XSetWindowBorder</function></funcdef>
+ <funcdef><function>XSetWindowBorder</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
<paramdef>unsignedlong<parameter> border_pixel</parameter></paramdef>
@@ -3865,18 +3865,18 @@ The <function>XSetWindowBorder</function>
function sets the border of the window to the pixel value you specify.
If you attempt to perform this on an
-<function>InputOnly</function>
+<symbol>InputOnly</symbol>
window, a
-<function>BadMatch</function>
+<errorname>BadMatch</errorname>
error results.
</para>
<para>
<!-- .LP -->
<function>XSetWindowBorder</function>
can generate
-<function>BadMatch </function>
+<errorname>BadMatch</errorname>
and
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
errors.
</para>
<para>
@@ -3888,7 +3888,7 @@ To change and repaint the border tile of a given window, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XSetWindowBorderPixmap</function></funcdef>
+ <funcdef><function>XSetWindowBorderPixmap</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
<paramdef>Pixmap<parameter> border_pixmap</parameter></paramdef>
@@ -3923,7 +3923,7 @@ Specifies the window. <listitem>
<para>
Specifies the border pixmap or
-<function>CopyFromParent</function>.
+<symbol>CopyFromParent</symbol>.
</para>
</listitem>
</varlistentry>
@@ -3938,12 +3938,12 @@ function sets the border pixmap of the window to the pixmap you specify. The border pixmap can be freed immediately if no further explicit
references to it are to be made.
If you specify
-<function>CopyFromParent</function>,
+<symbol>CopyFromParent</symbol>,
a copy of the parent window's border pixmap is used.
If you attempt to perform this on an
-<function>InputOnly</function>
+<symbol>InputOnly</symbol>
window, a
-<function>BadMatch</function>
+<errorname>BadMatch</errorname>
error results.
<indexterm><primary>Resource IDs</primary><secondary>freeing</secondary></indexterm>
<indexterm><primary>Freeing</primary><secondary>resources</secondary></indexterm>
@@ -3952,10 +3952,10 @@ error results. <!-- .LP -->
<function>XSetWindowBorderPixmap</function>
can generate
-<function>BadMatch</function>,
-<function>BadPixmap</function>,
+<errorname>BadMatch</errorname>,
+<errorname>BadPixmap</errorname>,
and
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
errors.
</para>
<para>
@@ -3967,7 +3967,7 @@ To set the colormap of a given window, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XSetWindowColormap</function></funcdef>
+ <funcdef><function>XSetWindowColormap</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
<paramdef>Colormap<parameter> colormap</parameter></paramdef>
@@ -4015,17 +4015,17 @@ The function sets the specified colormap of the specified window.
The colormap must have the same visual type as the window,
or a
-<function>BadMatch</function>
+<errorname>BadMatch</errorname>
error results.
</para>
<para>
<!-- .LP -->
<function>XSetWindowColormap</function>
can generate
-<function>BadColor</function>,
-<function>BadMatch</function>,
+<errorname>BadColor</errorname>,
+<errorname>BadMatch</errorname>,
and
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
errors.
</para>
<para>
@@ -4038,7 +4038,7 @@ To define which cursor will be used in a window, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XDefineCursor</function></funcdef>
+ <funcdef><function>XDefineCursor</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
<paramdef>Cursor<parameter> cursor</parameter></paramdef>
@@ -4073,7 +4073,7 @@ Specifies the window. <listitem>
<para>
Specifies the cursor that is to be displayed or
-<function>None</function>.
+<symbol>None</symbol>.
</para>
</listitem>
</varlistentry>
@@ -4084,7 +4084,7 @@ Specifies the cursor that is to be displayed or <!-- .eM -->
If a cursor is set, it will be used when the pointer is in the window.
If the cursor is
-<function>None</function>,
+<symbol>None</symbol>,
it is equivalent to
<function>XUndefineCursor</function>.
</para>
@@ -4092,9 +4092,9 @@ it is equivalent to <!-- .LP -->
<function>XDefineCursor</function>
can generate
-<function>BadCursor</function>
+<errorname>BadCursor</errorname>
and
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
errors.
</para>
<para>
@@ -4107,7 +4107,7 @@ To undefine the cursor in a given window, use <!-- .sM -->
<funcsynopsis>
<funcprototype>
- <funcdef><function> XUndefineCursor</function></funcdef>
+ <funcdef><function>XUndefineCursor</function></funcdef>
<paramdef>Display<parameter> *display</parameter></paramdef>
<paramdef>Window<parameter> w</parameter></paramdef>
</funcprototype>
@@ -4153,7 +4153,7 @@ the default cursor is restored. <!-- .LP -->
<function>XUndefineCursor</function>
can generate a
-<function>BadWindow </function>
+<errorname>BadWindow</errorname>
error.
<!-- .bp -->
|