<F8><Index, "control", "grabbing the server", To Named = p1rule><Index, "server", "grabbing", To Named = p1rule><Index, "grabbing", "server", To Named = p1rule>Grabbing<Tab>
<F6>14.1<#04><F0>Certain cases may require that a client demand
exclusive access to the<FJ>
<p1para,
Alignment = Both,
Font = F3,
Allow Page Break After = yes>
<F8>the Server<Tab><F0>server,<SP>causing the processing for all
other clients to be suspended. Such exclusive<SP>access is referred
to as <F2>grabbing the server<F0>. CLX provides functions to grab<SP>and
release exclusive access to the server. These function should be used<SP>rarely
and always with extreme caution, since they have the potential to<SP>disrupt
<F2>mapping<F3> <#1f> Type <F0>sequence<F3> or <F0>card8<F2>.<F3>
<para>
Returns or (with <F6>setf<F0>) changes the mapping of button numbers
for the <F2>display<F0><SP>pointer. The <F6>:result<#1e>type<F0>
is not used when changing the mapping. If element <F2>i<F0> of the
mapping sequence is <F2>j<F0>, then the events from pointer button<SP><F2>j
<F0> are reported by the server as events for button <F2>i<F0>+1.
(Note that pointer<SP>buttons are numbered beginning with one, while
the mapping sequence itself is<SP>indexed normally from zero.) If
element <F2>i<F0> of the mapping sequence is<SP>zero, then button <F2>i
<F0>+1 is disabled and can no longer generate input<SP>events. No
two elements of the mapping can have the same non<#1e>zero value.
The length of the mapping sequence indicates the actual number of
buttons on<SP>the device. When changing the mapping, the new mapping
must have this same length.
<arg>
display <F3><#1f> A <F6>display<F3>.
<keyword2>
:result<#1e>type <F3><#1f> The type of sequence to return.
<p1rule,
Allow Page Break After = yes>
<Index, "keyboard", "bell"><Index, "pointer", "button", "obtaining", To Named = p1rule><Index, "pointer", "button", "setting", To Named = p1rule><Index, "bit vector", "keyboard", To Named = p1rule><Index, "keyboard", "bit vector", To Named = p1rule><Index, "keyboard", "mapping", To Named = p1rule><Index, "mouse", "behavior", To Named = p1rule><Index, "key", "click", To Named = p1rule><Index, "bell", To Named = p1rule><Index, "key", "auto<#1e>repeat", To Named = p1rule><Index, "auto<#1e>repeat keys", To Named = p1rule><Index, "keyboard", "control", To Named = p1rule><Index, "control", "keyboard", To Named = p1rule>
<Frame,
Name = p1rule,
Placement = At Anchor,
Width = 6.35 inches,
Height = 0.153 inches,
Vertical Alignment = 0.007 inches,
Shared Contents = yes>
<p1stacked,
Font = F3,
Left Tab = -1.70/0 inches>
<F8>Keyboard <Tab><F6>14.3<F0><#04>The following paragraphs describe
the CLX functions used to:
<p1para,
Alignment = Both,
Font = F3,
Allow Page Break After = yes>
<F8>Control<Tab>
<bullet>
<F9>w<Tab><F0>Return or change keyboard controls
<F9>w<Tab><F0>Ring the keyboard bell
<F9>w<Tab><F0>Return or change the mapping of modifiers
<F9>w<Tab><F0>Return the current up/down state of all keys
<syntax>
bell <F2>display <F3>&optional (<F2>percent<#1e>from<#1e>normal<F3>