head	1.4;
access;
symbols
	core-8-5-9:1.2
	core-8-5-8:1.2
	macosx-cocoa-merge:1.4
	macosx-cocoa-premerge:1.4
	macosx-carbon-freeze:1.4
	core-8-5-7:1.2
	core-8-5-6:1.2
	core-8-6-b1:1.4
	core-8-6-a3:1.4
	core-8-5-5:1.2
	core-8-6-a2:1.4
	core-8-5-4:1.2
	core-8-5-3:1.2
	core-8-6-a1:1.2
	core-8-4-19:1.1
	core-8-5-branch:1.2.0.4
	core-8-5-2:1.2
	core-8-4-18:1.1
	core-8-5-1:1.2
	core-8-4-17:1.1
	core-8-5-0:1.2
	core-8-5-b3:1.2
	core-8-5-b2:1.2
	core-8-4-16:1.1
	core-8-5-b1:1.2
	core-stablilizer-merge:1.2
	core-stabilizer-branch:1.2.0.2
	core-stabilizer-merge:1.2
	core-8-4-15:1.1
	core-8-5-a6:1.2
	core-8-5-a5:1.2
	core-8-4-14:1.1
	core-8-5-a4:1.2
	core-8-4-13:1.1
	core-8-4-12:1.1
	core-8-4-11:1.1
	core-8-5-a3:1.2
	core-8-4-10:1.1
	core-8-4-9-branch:1.1.0.14
	core-8-5-a2:1.2
	core-8-4-9:1.1
	core-8-4-8:1.1
	core-8-4-7:1.1
	core-8-5-a1:1.1
	core-8-4-6:1.1
	core-8-4-5:1.1
	mistachkin-dev-branch:1.1.0.12
	core-8-4-4:1.1
	core-8-4-3:1.1
	core-8-4-branch:1.1.0.10
	core-8-4-2:1.1
	core-8-4-1:1.1
	core-8-3-5:1.1
	core-8-4-0:1.1
	macosx-8-4-merge-2002-08-31-trunk:1.1
	macosx-8-4-premerge-2002-08-31-branch:1.1
	macosx-8-4-premerge-2002-08-31-trunk:1.1
	macosx-8-4-merge-2002-08-30-branch:1.1
	macosx-8-4-merge-2002-08-30-trunk:1.1
	macosx-8-4-merge-2002-08-20-branch:1.1
	macosx-8-4-merge-2002-08-20-trunk:1.1
	core-8-4-b2:1.1
	core-8-4-b1:1.1
	macosx-premerge-6-9-02:1.1
	core-8-4-a4:1.1
	core-8-3-4:1.1
	macosx-8-4-branch:1.1.0.8
	macosx-8-4-branchpoint:1.1
	core-8-4-a3:1.1
	core-8-3-3:1.1
	dgp-privates-into-namespace:1.1.0.6
	tclpro-1-5-0:1.1
	core-8-4-win-speedup:1.1.0.4
	core-8-4-a2:1.1
	tclpro-1-4-1:1.1
	tclpro-1-4-0:1.1
	core-8-3-2:1.1
	ajuba-ajuba2-2-1-base:1.1
	ajuba-ajuba2-2-0:1.1
	core-8-4-a1:1.1
	core-8-3-1-branch:1.1.0.2
	core-8-3-1:1.1;
locks; strict;
comment	@.\" @;


1.4
date	2008.07.08.22.40.50;	author patthoyts;	state Exp;
branches;
next	1.3;

1.3
date	2008.06.30.22.57.01;	author dkf;	state Exp;
branches;
next	1.2;

1.2
date	2004.09.19.16.05.36;	author dkf;	state Exp;
branches;
next	1.1;

1.1
date	2000.04.25.02.12.15;	author ericm;	state Exp;
branches;
next	;


desc
@@


1.4
log
@Fixed broken line endings from last doc commit
@
text
@'\"
'\" Copyright (c) 1998-2000 by Scriptics Corporation.
'\" All rights reserved.
'\" 
'\" RCS: @@(#) $Id: Grab.3,v 1.3 2008/06/30 22:57:01 dkf Exp $
'\" 
.so man.macros
.TH Tk_Grab 3 "" Tk "Tk Library Procedures"
.BS
.SH NAME
Tk_Grab, Tk_Ungrab \- manipulate grab state in an application
.SH SYNOPSIS
.nf
\fB#include <tk.h>\fR
.sp
int
\fBTk_Grab\fR(\fIinterp, tkwin, grabGlobal\fR)
.sp
void
\fBTk_Ungrab\fR(\fItkwin\fR)
.SH ARGUMENTS
.AP Tcl_Interp *interp in
Interpreter to use for error reporting
.AP Tk_Window tkwin in
Window on whose behalf the pointer is to be grabbed or released
.AP int grabGlobal in
Boolean indicating whether the grab is global or application local
.BE
.SH DESCRIPTION
.PP
These functions are used to set or release a global or
application local grab.  When a grab is set on a particular window
in a Tk application, mouse and keyboard events can only be received by
that window and its descendants.  Mouse and keyboard events for
windows outside the tree rooted at \fItkwin\fR will be redirected to
\fItkwin\fR.  If the grab is global, then all mouse and keyboard
events for windows outside the tree rooted at \fItkwin\fR (even those
intended for windows in other applications) will be redirected to
\fItkwin\fR.  If the grab is application local, only mouse and
keyboard events intended for a windows within the same application
(but outside the tree rooted at \fItkwin\fR) will be redirected.
.PP
\fBTk_Grab\fR sets a grab on a particular window.  \fITkwin\fR
specifies the window on whose behalf the pointer is to be grabbed.
\fIGrabGlobal\fR indicates whether the grab should be global or
application local; if it is non-zero, it means the grab should be
global.  Normally, \fBTk_Grab\fR returns \fBTCL_OK\fR; if an error occurs
and the grab cannot be set, \fBTCL_ERROR\fR is returned and an error message
is left if \fIinterp\fR's result.  Once this call completes
successfully, no window outside the tree rooted at \fItkwin\fR will
receive pointer- or keyboard-related events until the next call to
Tk_Ungrab.  If a previous grab was in effect within the application,
then it is replaced with a new one.
.PP
\fBTcl_Ungrab\fR releases a grab on the mouse pointer and keyboard, if
there is one set on the window given by \fItkwin\fR.  Once a grab is
released, pointer and keyboard events will start being delivered to
other windows again.
.SH KEYWORDS
grab, window
@


1.3
log
@Minor doc updates (removing out of date changebars, improving typedef formatting,
 etc.)
@
text
@d1 60
a60 60
'\"
'\" Copyright (c) 1998-2000 by Scriptics Corporation.
'\" All rights reserved.
'\" 
'\" RCS: @@(#) $Id: Grab.3,v 1.2 2004/09/19 16:05:36 dkf Exp $
'\" 
.so man.macros
.TH Tk_Grab 3 "" Tk "Tk Library Procedures"
.BS
.SH NAME
Tk_Grab, Tk_Ungrab \- manipulate grab state in an application
.SH SYNOPSIS
.nf
\fB#include <tk.h>\fR
.sp
int
\fBTk_Grab\fR(\fIinterp, tkwin, grabGlobal\fR)
.sp
void
\fBTk_Ungrab\fR(\fItkwin\fR)
.SH ARGUMENTS
.AP Tcl_Interp *interp in
Interpreter to use for error reporting
.AP Tk_Window tkwin in
Window on whose behalf the pointer is to be grabbed or released
.AP int grabGlobal in
Boolean indicating whether the grab is global or application local
.BE
.SH DESCRIPTION
.PP
These functions are used to set or release a global or
application local grab.  When a grab is set on a particular window
in a Tk application, mouse and keyboard events can only be received by
that window and its descendants.  Mouse and keyboard events for
windows outside the tree rooted at \fItkwin\fR will be redirected to
\fItkwin\fR.  If the grab is global, then all mouse and keyboard
events for windows outside the tree rooted at \fItkwin\fR (even those
intended for windows in other applications) will be redirected to
\fItkwin\fR.  If the grab is application local, only mouse and
keyboard events intended for a windows within the same application
(but outside the tree rooted at \fItkwin\fR) will be redirected.
.PP
\fBTk_Grab\fR sets a grab on a particular window.  \fITkwin\fR
specifies the window on whose behalf the pointer is to be grabbed.
\fIGrabGlobal\fR indicates whether the grab should be global or
application local; if it is non-zero, it means the grab should be
global.  Normally, \fBTk_Grab\fR returns \fBTCL_OK\fR; if an error occurs
and the grab cannot be set, \fBTCL_ERROR\fR is returned and an error message
is left if \fIinterp\fR's result.  Once this call completes
successfully, no window outside the tree rooted at \fItkwin\fR will
receive pointer- or keyboard-related events until the next call to
Tk_Ungrab.  If a previous grab was in effect within the application,
then it is replaced with a new one.
.PP
\fBTcl_Ungrab\fR releases a grab on the mouse pointer and keyboard, if
there is one set on the window given by \fItkwin\fR.  Once a grab is
released, pointer and keyboard events will start being delivered to
other windows again.
.SH KEYWORDS
grab, window
@


1.2
log
@Standardize style of section refs & public symbols. Remove displayed tabs
@
text
@d1 60
a60 65
'\"
'\" Copyright (c) 1998-2000 by Scriptics Corporation.
'\" All rights reserved.
'\" 
'\" RCS: @@(#) $Id: Grab.3,v 1.1 2000/04/25 02:12:15 ericm Exp $
'\" 
.so man.macros
.TH Tk_Grab 3 "" Tk "Tk Library Procedures"
.BS
.SH NAME
Tk_Grab, Tk_Ungrab \- manipulate grab state in an application
.SH SYNOPSIS
.nf
\fB#include <tk.h>\fR
.sp
int
\fBTk_Grab\fR(\fIinterp, tkwin, grabGlobal\fR)
.sp
void
\fBTk_Ungrab\fR(\fItkwin\fR)

.SH ARGUMENTS
.AP Tcl_Interp *interp in
Interpreter to use for error reporting
.AP Tk_Window tkwin in
Window on whose behalf the pointer is to be grabbed or released
.AP int grabGlobal in
Boolean indicating whether the grab is global or application local
.BE

.SH DESCRIPTION
.PP
These functions are used to set or release a global or
application local grab.  When a grab is set on a particular window
in a Tk application, mouse and keyboard events can only be received by
that window and its descendants.  Mouse and keyboard events for
windows outside the tree rooted at \fItkwin\fR will be redirected to
\fItkwin\fR.  If the grab is global, then all mouse and keyboard
events for windows outside the tree rooted at \fItkwin\fR (even those
intended for windows in other applications) will be redirected to
\fItkwin\fR.  If the grab is application local, only mouse and
keyboard events intended for a windows within the same application
(but outside the tree rooted at \fItkwin\fR) will be redirected.

.PP
\fBTk_Grab\fR sets a grab on a particular window.  \fITkwin\fR
specifies the window on whose behalf the pointer is to be grabbed.
\fIGrabGlobal\fR indicates whether the grab should be global or
application local; if it is non-zero, it means the grab should be
global.  Normally, \fBTk_Grab\fR returns \fBTCL_OK\fR; if an error occurs
and the grab cannot be set, \fBTCL_ERROR\fR is returned and an error message
is left if \fIinterp\fR's result.  Once this call completes
successfully, no window outside the tree rooted at \fItkwin\fR will
receive pointer- or keyboard-related events until the next call to
Tk_Ungrab.  If a previous grab was in effect within the application,
then it is replaced with a new one.

.PP
\fBTcl_Ungrab\fR releases a grab on the mouse pointer and keyboard, if
there is one set on the window given by \fItkwin\fR.  Once a grab is
released, pointer and keyboard events will start being delivered to
other windows again.

.SH KEYWORDS
grab, window
@


1.1
log
@* unix/mkLinks:
* doc/Grab.3: Man page for Tk_Grab and Tk_Ungrab [Bug: 1868, 1889]
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id$
d50 2
a51 2
global.  Normally, \fBTk_Grab\fR returns TCL_OK; if an error occurs
and the grab cannot be set, TCL_ERROR is returned and an error message
@

