summaryrefslogtreecommitdiffstats
path: root/doc/bind.n
diff options
context:
space:
mode:
Diffstat (limited to 'doc/bind.n')
-rw-r--r--doc/bind.n47
1 files changed, 18 insertions, 29 deletions
diff --git a/doc/bind.n b/doc/bind.n
index 8f20d76..31cdb9d 100644
--- a/doc/bind.n
+++ b/doc/bind.n
@@ -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