head 1.1; branch 1.1.1; access; symbols netbsd-11-0-RC4:1.1.1.4 netbsd-11-0-RC3:1.1.1.4 netbsd-11-0-RC2:1.1.1.4 netbsd-11-0-RC1:1.1.1.4 netbsd-11:1.1.1.4.0.6 netbsd-11-base:1.1.1.4 netbsd-10-1-RELEASE:1.1.1.4 libXt-1-3-1:1.1.1.4 netbsd-8-3-RELEASE:1.1.1.3 netbsd-9-4-RELEASE:1.1.1.4 netbsd-10-0-RELEASE:1.1.1.4 netbsd-10-0-RC6:1.1.1.4 netbsd-10-0-RC5:1.1.1.4 netbsd-10-0-RC4:1.1.1.4 netbsd-10-0-RC3:1.1.1.4 netbsd-10-0-RC2:1.1.1.4 netbsd-10-0-RC1:1.1.1.4 libXt-1-3-0:1.1.1.4 netbsd-10:1.1.1.4.0.4 netbsd-10-base:1.1.1.4 netbsd-9-3-RELEASE:1.1.1.4 netbsd-9-2-RELEASE:1.1.1.4 libXt-1-2-1:1.1.1.4 netbsd-9-1-RELEASE:1.1.1.4 netbsd-8-2-RELEASE:1.1.1.3 netbsd-9-0-RELEASE:1.1.1.4 netbsd-9-0-RC2:1.1.1.4 netbsd-9-0-RC1:1.1.1.4 netbsd-9:1.1.1.4.0.2 netbsd-9-base:1.1.1.4 libXt-1-2-0:1.1.1.4 netbsd-8-1-RELEASE:1.1.1.3 netbsd-8-1-RC1:1.1.1.3 netbsd-7-2-RELEASE:1.1.1.3 netbsd-8-0-RELEASE:1.1.1.3 netbsd-8-0-RC2:1.1.1.3 netbsd-8-0-RC1:1.1.1.3 netbsd-7-1-2-RELEASE:1.1.1.3 netbsd-7-1-1-RELEASE:1.1.1.3 netbsd-8:1.1.1.3.0.10 netbsd-8-base:1.1.1.3 netbsd-7-1:1.1.1.3.0.8 netbsd-7-1-RELEASE:1.1.1.3 netbsd-7-1-RC2:1.1.1.3 netbsd-7-1-RC1:1.1.1.3 netbsd-7-0-2-RELEASE:1.1.1.3 netbsd-7-0-1-RELEASE:1.1.1.3 netbsd-7-0:1.1.1.3.0.6 netbsd-7-0-RELEASE:1.1.1.3 netbsd-7-0-RC3:1.1.1.3 netbsd-7-0-RC2:1.1.1.3 libXt-1-1-5:1.1.1.3 netbsd-7-0-RC1:1.1.1.3 netbsd-5-2-3-RELEASE:1.1.1.1 netbsd-5-1-5-RELEASE:1.1.1.1 netbsd-6-0-6-RELEASE:1.1.1.2 netbsd-6-1-5-RELEASE:1.1.1.2 netbsd-7:1.1.1.3.0.4 netbsd-7-base:1.1.1.3 netbsd-6-1-4-RELEASE:1.1.1.2 netbsd-6-0-5-RELEASE:1.1.1.2 riastradh-xf86-video-intel-2-7-1-pre-2-21-15:1.1.1.3 riastradh-drm2:1.1.1.3.0.2 riastradh-drm2-base:1.1.1.3 netbsd-6-1-3-RELEASE:1.1.1.2 netbsd-6-0-4-RELEASE:1.1.1.2 netbsd-5-2-2-RELEASE:1.1.1.1 netbsd-5-1-4-RELEASE:1.1.1.1 netbsd-6-1-2-RELEASE:1.1.1.2 netbsd-6-0-3-RELEASE:1.1.1.2 netbsd-5-2-1-RELEASE:1.1.1.1 netbsd-5-1-3-RELEASE:1.1.1.1 netbsd-6-1-1-RELEASE:1.1.1.2 libXt-1-1-4:1.1.1.3 netbsd-6-1:1.1.1.2.0.6 netbsd-6-0-2-RELEASE:1.1.1.2 netbsd-6-1-RELEASE:1.1.1.2 netbsd-6-1-RC4:1.1.1.2 netbsd-6-1-RC3:1.1.1.2 netbsd-6-1-RC2:1.1.1.2 netbsd-6-1-RC1:1.1.1.2 netbsd-5-2:1.1.1.1.0.8 netbsd-6-0-1-RELEASE:1.1.1.2 netbsd-5-2-RELEASE:1.1.1.1 netbsd-5-2-RC1:1.1.1.1 netbsd-6-0:1.1.1.2.0.4 netbsd-6-0-RELEASE:1.1.1.2 netbsd-6-0-RC2:1.1.1.2 netbsd-6-0-RC1:1.1.1.2 netbsd-6:1.1.1.2.0.2 netbsd-6-base:1.1.1.2 netbsd-5-1-2-RELEASE:1.1.1.1 netbsd-5-1-1-RELEASE:1.1.1.1 libXt-1-1-1:1.1.1.2 libXt-1-0-9:1.1.1.2 netbsd-5-1:1.1.1.1.0.6 netbsd-5-1-RELEASE:1.1.1.1 netbsd-5-1-RC4:1.1.1.1 netbsd-5-1-RC3:1.1.1.1 libXt-1-0-8:1.1.1.1 netbsd-5-1-RC2:1.1.1.1 netbsd-5-1-RC1:1.1.1.1 netbsd-5-0-2-RELEASE:1.1.1.1 libXt-1-0-7:1.1.1.1 netbsd-5-0-1-RELEASE:1.1.1.1 libXt-1-0-6:1.1.1.1 netbsd-5-0:1.1.1.1.0.4 netbsd-5-0-RELEASE:1.1.1.1 netbsd-5-0-RC4:1.1.1.1 netbsd-5-0-RC3:1.1.1.1 netbsd-5-0-RC2:1.1.1.1 netbsd-5-0-RC1:1.1.1.1 netbsd-5:1.1.1.1.0.2 netbsd-5-base:1.1.1.1 libXt-1-0-5:1.1.1.1 xorg:1.1.1; locks; strict; comment @.\" @; 1.1 date 2008.07.30.02.56.54; author mrg; state Exp; branches 1.1.1.1; next ; 1.1.1.1 date 2008.07.30.02.56.54; author mrg; state Exp; branches; next 1.1.1.2; 1.1.1.2 date 2010.11.21.05.48.36; author mrg; state Exp; branches; next 1.1.1.3; 1.1.1.3 date 2013.05.31.09.19.54; author mrg; state Exp; branches; next 1.1.1.4; commitid UdAPYXenQVyEqLRw; 1.1.1.4 date 2019.07.11.05.43.09; author mrg; state Exp; branches; next ; commitid E2KJZD7NBiU8uAuB; desc @@ 1.1 log @Initial revision @ text @.\" $Xorg: XtGrabKey.man,v 1.3 2000/08/17 19:42:01 cpqbld Exp $ .\" .\" Copyright (c) 1993, 1994 X Consortium .\" .\" Permission is hereby granted, free of charge, to any person obtaining a .\" copy of this software and associated documentation files (the "Software"), .\" to deal in the Software without restriction, including without limitation .\" the rights to use, copy, modify, merge, publish, distribute, sublicense, .\" and/or sell copies of the Software, and to permit persons to whom the .\" Software furnished to do so, subject to the following conditions: .\" .\" The above copyright notice and this permission notice shall be included in .\" all copies or substantial portions of the Software. .\" .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR .\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, .\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL .\" THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, .\" WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF .\" OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE .\" SOFTWARE. .\" .\" Except as contained in this notice, the name of the X Consortium shall not .\" be used in advertising or otherwise to promote the sale, use or other .\" dealing in this Software without prior written authorization from the .\" X Consortium. .\" .\" $XFree86: xc/doc/man/Xt/XtGrabKey.man,v 1.3 2001/02/09 03:47:51 tsi Exp $ .\" .ds tk X Toolkit .ds xT X Toolkit Intrinsics \- C Language Interface .ds xI Intrinsics .ds xW X Toolkit Athena Widgets \- C Language Interface .ds xL Xlib \- C Language X Interface .ds xC Inter-Client Communication Conventions Manual .ds Rn 3 .ds Vn 2.2 .hw XtGrab-Key XtUngrab-Key XtGrab-Keyboard XtUngrab-Keyboard XtGrab-Button XtUngrab-Button XtGrab-Pointer XtUngrab-Pointer wid-get .na .de Ds .nf .\\$1D \\$2 \\$1 .ft 1 .ps \\n(PS .\".if \\n(VS>=40 .vs \\n(VSu .\".if \\n(VS<=39 .vs \\n(VSp .. .de De .ce 0 .if \\n(BD .DF .nr BD 0 .in \\n(OIu .if \\n(TM .ls 2 .sp \\n(DDu .fi .. .de FD .LP .KS .TA .5i 3i .ta .5i 3i .nf .. .de FN .fi .KE .LP .. .de IN \" send an index entry to the stderr .. .de C{ .KS .nf .D .\" .\" choose appropriate monospace font .\" the imagen conditional, 480, .\" may be changed to L if LB is too .\" heavy for your eyes... .\" .ie "\\*(.T"480" .ft L .el .ie "\\*(.T"300" .ft L .el .ie "\\*(.T"202" .ft PO .el .ie "\\*(.T"aps" .ft CW .el .ft R .ps \\n(PS .ie \\n(VS>40 .vs \\n(VSu .el .vs \\n(VSp .. .de C} .DE .R .. .de Pn .ie t \\$1\fB\^\\$2\^\fR\\$3 .el \\$1\fI\^\\$2\^\fP\\$3 .. .de ZN .ie t \fB\^\\$1\^\fR\\$2 .el \fI\^\\$1\^\fP\\$2 .. .de NT .ne 7 .ds NO Note .if \\n(.$>$1 .if !'\\$2'C' .ds NO \\$2 .if \\n(.$ .if !'\\$1'C' .ds NO \\$1 .ie n .sp .el .sp 10p .TB .ce \\*(NO .ie n .sp .el .sp 5p .if '\\$1'C' .ce 99 .if '\\$2'C' .ce 99 .in +5n .ll -5n .R .. . \" Note End -- doug kraft 3/85 .de NE .ce 0 .in -5n .ll +5n .ie n .sp .el .sp 10p .. .ny0 .TH XtGrabKey __libmansuffix__ __xorgversion__ "XT FUNCTIONS" .SH NAME XtGrabKey, XtUngrabKey, XtGrabKeyboard, XtUngrabKeyboard, XtGrabButton, XtUngrabButton, XtGrabPointer, XtUngrabPointer \- manage grabs .SH SYNTAX .HP void XtGrabKey(Widget \fIwidget\fP, KeyCode \fIkeycode\fP, Modifiers \fImodifiers\fP, Boolean \fIowner_events\fP, int \fIpointer_mode\fP, int \fIkeyboard_mode\fP); .HP void XtUngrabKey(Widget \fIwidget\fP, KeyCode \fIkeycode\fP, Modifiers \fImodifiers\fP); .HP int XtGrabKeyboard(Widget \fIwidget\fP, Boolean \fIowner_events\fP, int \fIpointer_mode\fP, int \fIkeyboard_mode\fP, Time \fItime\fP); .HP void XtUngrabKeyboard(Widget \fIwidget\fP, Time \fItime\fP); .HP void XtGrabButton(Widget \fIwidget\fP, int \fIbutton\fP, Modifiers \fImodifiers\fP, Boolean \fIowner_events\fP, unsigned int \fIevent_mask\fP, int \fIpointer_mode\fP, int \fIkeyboard_mode\fP, Window \fIconfine_to\fP, Cursor \fIcursor\fP); .HP void XtUngrabButton(Widget \fIwidget\fP, KeyCode \fIbutton\fP, Modifiers \fImodifiers\fP); .HP int XtGrabPointer(Widget \fIwidget\fP, Boolean \fIowner_events\fP, unsigned int \fIevent_mask\fP, int \fIpointer_mode\fP, int \fIkeyboard_mode\fP, Window \fIconfine_to\fP, Cursor \fIcursor\fP, Time \fItime\fP); .HP void XtUngrabPointer(Widget \fIwidget\fP, Time \fItime\fP); .SH ARGUMENTS .IP \fIwidget\fP 1i Specifies the widget in whose window the grab will occur. Must be of class Core or a subclass thereof. .sp 6p .IP \fIkeycode\fP .br .ns .IP \fImodifiers\fP .br .ns .IP \fIowner_events\fP .br .ns .IP \fIpointer_mode\fP .br .ns .IP \fIkeyboard_mode\fP .br .ns .IP \fItime\fP .br .ns .IP \fIbutton\fP .br .ns .IP \fIconfine_to\fP .br .ns .IP \fIcursor\fP 1i Specifies arguments to the associated Xlib function call. .SH DESCRIPTION .ZN XtGrabKey calls .ZN XGrabKey specifying the widget's window as the grab window if the widget is realized. The remaining arguments are exactly as for .ZN XGrabKey . If the widget is not realized, or is later unrealized, the call to .ZN XGrabKey will be performed (again) when the widget is realized and its window becomes mapped. In the future, if .ZN XtDispatchEvent is called with a .ZN KeyPress event matching the specified keycode and modifiers (which may be .ZN AnyKey or .ZN AnyModifier , respectively) for the widget's window, the Intrinsics will call .ZN XtUngrabKeyboard with the timestamp from the .ZN KeyPress event if either of the following conditions is true: .IP \(bu 3 There is a modal cascade and the widget is not in the active subset of the cascade and the keyboard was not previously grabbed, or .IP \(bu 3 .ZN XFilterEvent returns .ZN True . .LP .ZN XtUngrabKey calls .ZN XUngrabKey specifying the widget's window as the ungrab window if the widget is realized. The remaining arguments are exactly as for .ZN XUngrabKey . If the widget is not realized, .ZN XtUngrabKey removes a deferred .ZN XtGrabKey request, if any, for the specified widget, keycode, and modifiers. .LP If the specified widget is realized .ZN XtGrabKeyboard calls .ZN XGrabKeyboard specifying the widget's window as the grab window. The remaining arguments and return value are exactly as for .ZN XGrabKeyboard . If the widget is not realized, .ZN XtGrabKeyboard immediately returns .ZN GrabNotViewable . No future ungrab is implied by .ZN XtGrabKeyboard . .LP .ZN XtUngrabKeyboard calls .ZN XUngrabKeyboard with the specified time. .LP .ZN XtGrabButton calls .ZN XGrabButton specifying the widget's window as the grab window if the widget is realized. The remaining arguments are exactly as for .ZN XGrabButton . If the widget is not realized, or is later unrealized, the call to .ZN XGrabButton will be performed (again) when the widget is realized and its window becomes mapped. In the future, if .ZN XtDispatchEvent is called with a .ZN ButtonPress event matching the specified button and modifiers (which may be .ZN AnyButton or .ZN AnyModifier , respectively) for the widget's window, the Intrinsics will call .ZN XtUngrabPointer with the timestamp from the .ZN ButtonPress event if either of the following conditions is true: .IP \(bu 3 There is a modal cascade and the widget is not in the active subset of the cascade and the pointer was not previously grabbed, or .IP \(bu 3 .ZN XFilterEvent returns .ZN True . .LP .ZN XtUngrabButton calls .ZN XUngrabButton specifying the widget's window as the ungrab window if the widget is realized. The remaining arguments are exactly as for .ZN XUngrabButton . If the widget is not realized, .ZN XtUngrabButton removes a deferred .ZN XtGrabButton request, if any, for the specified widget, button, and modifiers. .LP .ZN XtGrabPointer calls .ZN XGrabPointer specifying the widget's window as the grab window. The remaining arguments and return value are exactly as for .ZN XGrabPointer . If the widget is not realized, .ZN XtGrabPointer immediately returns .ZN GrabNotViewable . No future ungrab is implied by .ZN XtGrabPointer . .LP .ZN XtUngrabPointer calls .ZN XUngrabPointer with the specified time. .SH "SEE ALSO" .br \fI\*(xT\fP .br \fI\*(xL\fP @ 1.1.1.1 log @initial import of libXt-1.0.5 @ text @@ 1.1.1.2 log @initial import of libXt-1.0.9 @ text @d1 2 d28 2 @ 1.1.1.3 log @initial import of libXt-1.1.4 @ text @d2 1 a2 1 .\" d4 4 a7 4 .\" copy of this software and associated documentation files (the "Software"), .\" to deal in the Software without restriction, including without limitation .\" the rights to use, copy, modify, merge, publish, distribute, sublicense, .\" and/or sell copies of the Software, and to permit persons to whom the d9 1 a9 1 .\" d12 1 a12 1 .\" d15 4 a18 4 .\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL .\" THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, .\" WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF .\" OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE d20 4 a23 4 .\" .\" Except as contained in this notice, the name of the X Consortium shall not .\" be used in advertising or otherwise to promote the sale, use or other .\" dealing in this Software without prior written authorization from the d39 1 a39 1 .ft CW d53 12 d67 23 d98 26 d132 1 a132 1 \fIkeyboard_mode\fP); d135 1 a135 1 \fImodifiers\fP); d138 1 a138 1 \fIpointer_mode\fP, int \fIkeyboard_mode\fP, Time \fItime\fP); d140 1 a140 1 void XtUngrabKeyboard(Widget \fIwidget\fP, Time \fItime\fP); d145 1 a145 1 Cursor \fIcursor\fP); d148 1 a148 1 \fImodifiers\fP); d152 1 a152 1 \fIconfine_to\fP, Cursor \fIcursor\fP, Time \fItime\fP); d154 1 a154 1 void XtUngrabPointer(Widget \fIwidget\fP, Time \fItime\fP); d194 1 a194 1 .ZN XGrabKey d255 1 a255 1 .ZN XGrabButton @ 1.1.1.4 log @initial import of libXt-1.2.0 @ text @d34 1 a34 2 .hw XtGrab-Key XtUngrab-Key XtGrab-Keyboard XtUngrab-Keyboard .hw XtGrab-Button XtUngrab-Button XtGrab-Pointer XtUngrab-Pointer wid-get d36 28 a67 1 #include d86 1 a86 1 void XtUngrabButton(Widget \fIwidget\fP, unsigned \fIbutton\fP, Modifiers d96 1 a96 2 Specifies the widget in whose window the grab will occur. Must be of d126 1 a126 1 .B XtGrabKey d128 1 a128 1 .B XGrabKey d130 2 a131 3 realized. The remaining arguments are exactly as for .BR XGrabKey . d133 1 a133 1 .B XGrabKey d135 2 a136 3 becomes mapped. In the future, if .B XtDispatchEvent d138 1 a138 1 .B KeyPress d140 1 a140 1 .B AnyKey d142 1 a142 1 .BR AnyModifier , d144 1 a144 1 .B XtUngrabKeyboard d146 1 a146 1 .B KeyPress d152 1 a152 1 .B XFilterEvent d154 1 a154 1 .BR True . d156 1 a156 1 .B XtUngrabKey d158 1 a158 1 .B XUngrabKey d160 2 a161 3 realized. The remaining arguments are exactly as for .BR XUngrabKey . d163 1 a163 1 .B XtUngrabKey d165 1 a165 1 .B XtGrabKey d169 1 a169 1 .B XtGrabKeyboard d171 2 a172 3 .B XGrabKeyboard specifying the widget's window as the grab window. The remaining d174 1 a174 1 .BR XGrabKeyboard . d176 1 a176 1 .B XtGrabKeyboard d178 1 a178 1 .BR GrabNotViewable . d180 1 a180 1 .BR XtGrabKeyboard . d182 1 a182 1 .B XtUngrabKeyboard d184 1 a184 1 .B XUngrabKeyboard d187 1 a187 1 .B XtGrabButton d189 1 a189 1 .B XGrabButton d191 2 a192 3 realized. The remaining arguments are exactly as for .BR XGrabButton . d194 1 a194 1 .B XGrabButton d196 2 a197 3 becomes mapped. In the future, if .B XtDispatchEvent d199 1 a199 1 .B ButtonPress d201 1 a201 1 .B AnyButton d203 1 a203 1 .BR AnyModifier , d205 1 a205 1 .B XtUngrabPointer d207 1 a207 1 .B ButtonPress d213 1 a213 1 .B XFilterEvent d215 1 a215 1 .BR True . d217 1 a217 1 .B XtUngrabButton d219 1 a219 1 .B XUngrabButton d221 2 a222 3 realized. The remaining arguments are exactly as for .BR XUngrabButton . d224 1 a224 1 .B XtUngrabButton d226 1 a226 1 .B XtGrabButton d229 1 a229 1 .B XtGrabPointer d231 2 a232 3 .B XGrabPointer specifying the widget's window as the grab window. The remaining d234 1 a234 1 .BR XGrabPointer . d236 1 a236 1 .B XtGrabPointer d238 1 a238 1 .BR GrabNotViewable . d240 1 a240 1 .BR XtGrabPointer . d242 1 a242 1 .B XtUngrabPointer d244 1 a244 1 .B XUngrabPointer @