diff options
Diffstat (limited to 'doc/bind.n')
| -rw-r--r-- | doc/bind.n | 47 |
1 files changed, 18 insertions, 29 deletions
@@ -6,7 +6,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: bind.n,v 1.23 2007/10/26 12:25:38 dkf Exp $ +'\" RCS: @(#) $Id: bind.n,v 1.24 2007/10/26 20:13:23 dgp Exp $ '\" .so man.macros .TH bind n 8.0 Tk "Tk Built-In Commands" @@ -25,9 +25,7 @@ If all three arguments are specified, \fBbind\fR will arrange for \fIscript\fR (a Tcl script) to be evaluated whenever the event(s) given by \fIsequence\fR occur in the window(s) identified by \fItag\fR. -If \fIscript\fR is prefixed with a -.QW + , -then it is appended to +If \fIscript\fR is prefixed with a ``+'', then it is appended to any existing binding for \fIsequence\fR; otherwise \fIscript\fR replaces any existing binding. If \fIscript\fR is an empty string then the current binding for @@ -168,7 +166,7 @@ couple non-standard X event types that were added to better support the Macintosh and Windows platforms. Below is a list of all the valid types; where two names appear together, they are synonyms. .DS -.ta 2.5i +2i +.ta \w'ButtonPress, Button\0\0\0'u +\w'KeyPress, Key\0\0\0'u \fBActivate Destroy Map ButtonPress, Button Enter MapRequest ButtonRelease Expose Motion @@ -269,9 +267,9 @@ A \fBDestroy\fR event is delivered to a window when it is destroyed. .RS .PP -When the \fBDestroy\fR event is delivered to a widget, it is in a -.QW half-dead -state: the widget still exists, but most operations on it will fail. +When the \fBDestroy\fR event is delivered +to a widget, it is in a ``half-dead'' state: the widget still exists, +but most operations on it will fail. .RE .IP "\fBFocusIn\fR, \fBFocusOut\fR" 5 The \fBFocusIn\fR and \fBFocusOut\fR events are generated @@ -282,8 +280,8 @@ and a \fBFocusIn\fR event is sent to the new one. .PP In addition, if the old and new focus windows do not share a common parent, -.QW "virtual crossing" -focus events are sent to the intermediate windows in the hierarchy. +``virtual crossing'' focus events are sent to the intermediate +windows in the hierarchy. Thus a \fBFocusIn\fR event indicates that the target window or one of its descendants has acquired the focus, and a \fBFocusOut\fR event indicates that the focus @@ -303,8 +301,7 @@ events are only delivered to the window owning the grab. .PP In addition, when the pointer moves between two windows, \fBEnter\fR and \fBLeave\fR -.QW "virtual crossing" -events are sent to intermediate windows +``virtual crossing'' events are sent to intermediate windows in the hierarchy in the same manner as for \fBFocusIn\fR and \fBFocusOut\fR events. .RE @@ -367,19 +364,12 @@ is equivalent to \fB<ButtonPress-1>\fR. If the event type is \fBKeyPress\fR or \fBKeyRelease\fR, then \fIdetail\fR may be specified in the form of an X keysym. Keysyms are textual specifications for particular keys on the keyboard; -they include all the alphanumeric ASCII characters (e.g. -.QW a -is the keysym for the ASCII character -.QW a ), -plus descriptions for non-alphanumeric characters (e.g. -.QW comma -is the keysym for the comma +they include all the alphanumeric ASCII characters (e.g. ``a'' is +the keysym for the ASCII character ``a''), plus descriptions for +non-alphanumeric characters (``comma'' is the keysym for the comma character), plus descriptions for all the non-ASCII keys on the -keyboard (e.g. -.QW Shift_L -is the keysym for the left shift key, and -.QW F1 -is the keysym for the F1 function key, if it exists). The +keyboard (``Shift_L'' is the keysym for the left shift key, and +``F1'' is the keysym for the F1 function key, if it exists). The complete list of keysyms is not presented here; it is available in other X documentation and may vary from system to system. @@ -540,11 +530,8 @@ the delta. The sign of the value represents the direction the mouse wheel was scrolled. .IP \fB%E\fR 5 The \fIsend_event\fR field from the event. Valid for all event types. -\fB0\fR indicates that this is a -.QW normal -event, \fB1\fR indicates that it is a -.QW synthetic -event generated by \fBSendEvent\fR. +\fB0\fR indicates that this is a ``normal'' event, \fB1\fR indicates +that it is a ``synthetic'' event generated by \fBSendEvent\fR. .IP \fB%K\fR 5 The keysym corresponding to the event, substituted as a textual string. Valid only for \fBKeyPress\fR and \fBKeyRelease\fR events. @@ -712,7 +699,9 @@ pack [label .l -textvariable keysym -padx 2m -pady 1m] set keysym "You pressed %K" } .CE + .SH "SEE ALSO" bgerror(n), bindtags(n), event(n), focus(n), grab(n), keysyms(n) + .SH KEYWORDS binding, event |