OpenCores
URL https://opencores.org/ocsvn/or1k/or1k/trunk

Subversion Repositories or1k

[/] [or1k/] [trunk/] [insight/] [tk/] [doc/] [focusNext.n] - Blame information for rev 1765

Details | Compare with Previous | View Log

Line No. Rev Author Line
1 578 markom
'\"
2
'\" Copyright (c) 1994 The Regents of the University of California.
3
'\" Copyright (c) 1994-1996 Sun Microsystems, Inc.
4
'\"
5
'\" See the file "license.terms" for information on usage and redistribution
6
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
7
'\"
8
'\" RCS: @(#) $Id: focusNext.n,v 1.1.1.1 2002-01-16 10:25:49 markom Exp $
9
'\"
10
.so man.macros
11
.TH tk_focusNext n 4.0 Tk "Tk Built-In Commands"
12
.BS
13
'\" Note:  do not modify the .SH NAME line immediately below!
14
.SH NAME
15
tk_focusNext, tk_focusPrev, tk_focusFollowsMouse \- Utility procedures for managing the input focus.
16
.SH SYNOPSIS
17
\fBtk_focusNext \fIwindow\fR
18
.sp
19
\fBtk_focusPrev \fIwindow\fR
20
.sp
21
\fBtk_focusFollowsMouse\fR
22
.BE
23
 
24
.SH DESCRIPTION
25
.PP
26
\fBtk_focusNext\fR is a utility procedure used for keyboard traversal.
27
It returns the ``next'' window after \fIwindow\fR in focus order.
28
The focus order is determined by
29
the stacking order of windows and the structure of the window hierarchy.
30
Among siblings, the focus order is the same as the stacking order, with the
31
lowest window being first.
32
If a window has children, the window is visited first, followed by
33
its children (recursively), followed by its next sibling.
34
Top-level windows other than \fIwindow\fR are skipped, so that
35
\fBtk_focusNext\fR never returns a window in a different top-level
36
from \fIwindow\fR.
37
.PP
38
After computing the next window, \fBtk_focusNext\fR examines the
39
window's \fB\-takefocus\fR option to see whether it should be skipped.
40
If so, \fBtk_focusNext\fR continues on to the next window in the focus
41
order, until it eventually finds a window that will accept the focus
42
or returns back to \fIwindow\fR.
43
.PP
44
\fBtk_focusPrev\fR is similar to \fBtk_focusNext\fR except that it
45
returns the window just before \fIwindow\fR in the focus order.
46
.PP
47
\fBtk_focusFollowsMouse\fR changes the focus model for the application
48
to an implicit one where the window under the mouse gets the focus.
49
After this procedure is called, whenever the mouse enters a window
50
Tk will automatically give it the input focus.
51
The \fBfocus\fR command may be used to move the focus to a window
52
other than the one under the mouse, but as soon as the mouse moves
53
into a new window the focus will jump to that window.
54
Note: at present there is no built-in support for returning the
55
application to an explicit focus model;  to do this you'll have
56
to write a script that deletes the bindings created by
57
\fBtk_focusFollowsMouse\fR.
58
 
59
.SH KEYWORDS
60
focus, keyboard traversal, top-level

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.