2 '\" Copyright (c) 1990-1994 The Regents of the University of California.
3 '\" Copyright (c) 1994-1996 Sun Microsystems, Inc.
5 '\" See the file "license.terms" for information on usage and redistribution
6 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
8 '\" RCS: @(#) $Id: ManageGeom.3,v 1.2 1998/09/14 18:22:52 stanton Exp $
10 '\" The definitions below are for supplemental macros used in Tcl/Tk
13 '\" .AP type name in/out ?indent?
14 '\" Start paragraph describing an argument to a library procedure.
15 '\" type is type of argument (int, etc.), in/out is either "in", "out",
16 '\" or "in/out" to describe whether procedure reads or modifies arg,
17 '\" and indent is equivalent to second arg of .IP (shouldn't ever be
18 '\" needed; use .AS below instead)
21 '\" Give maximum sizes of arguments for setting tab stops. Type and
22 '\" name are examples of largest possible arguments that will be passed
23 '\" to .AP later. If args are omitted, default tab stops are used.
26 '\" Start box enclosure. From here until next .BE, everything will be
27 '\" enclosed in one large box.
30 '\" End of box enclosure.
33 '\" Begin code excerpt.
38 '\" .VS ?version? ?br?
39 '\" Begin vertical sidebar, for use in marking newly-changed parts
40 '\" of man pages. The first argument is ignored and used for recording
41 '\" the version when the .VS was added, so that the sidebars can be
42 '\" found and removed when they reach a certain age. If another argument
43 '\" is present, then a line break is forced before starting the sidebar.
46 '\" End of vertical sidebar.
49 '\" Begin an indented unfilled display.
52 '\" End of indented unfilled display.
55 '\" Start of list of standard options for a Tk widget. The
56 '\" options follow on successive lines, in four columns separated
60 '\" End of list of standard options for a Tk widget.
62 '\" .OP cmdName dbName dbClass
63 '\" Start of description of a specific option. cmdName gives the
64 '\" option's name as specified in the class command, dbName gives
65 '\" the option's name in the option database, and dbClass gives
66 '\" the option's class in the option database.
69 '\" Print arg1 underlined, then print arg2 normally.
71 '\" RCS: @(#) $Id: man.macros,v 1.4 2000/08/25 06:18:32 ericm Exp $
73 '\" # Set up traps and other miscellaneous stuff for Tcl/Tk man pages.
77 '\" # Start an argument description
81 . ie !"\\$2"" .TP \\n()Cu
86 \&\\$1 \\fI\\$2\\fP (\\$3)
99 '\" # define tabbing values for .AP
102 .if !"\\$1"" .nr )A \\w'\\$1'u+3n
105 .if !"\\$2"" .nr )B \\w'\\$2'u+\\n()Au+3n
106 .nr )C \\n()Bu+\\w'(in/out)'u+2n
108 .AS Tcl_Interp Tcl_CreateInterp in/out
109 '\" # BS - start boxed text
110 '\" # ^y = starting y location
118 .if n \l'\\n(.lu\(ul'
121 '\" # BE - end boxed text (draw box now)
126 .ie n \l'\\n(^lu\(ul'
128 .\" Draw four-sided box normally, but don't draw top of
129 .\" box if the box started on an earlier page.
131 \h'-1.5n'\L'|\\n(^yu-1v'\l'\\n(^lu+3n\(ul'\L'\\n(^tu+1v-\\n(^yu'\l'|0u-1.5n\(ul'
134 \h'-1.5n'\L'|\\n(^yu-1v'\h'\\n(^lu+3n'\L'\\n(^tu+1v-\\n(^yu'\l'|0u-1.5n\(ul'
141 '\" # VS - start vertical sidebar
142 '\" # ^Y = starting y location
143 '\" # ^v = 1 (for troff; for nroff this doesn't matter)
147 .ie n 'mc \s12\(br\s0
150 '\" # VE - end of vertical sidebar
158 \h'|\\n(^lu+3n'\L'|\\n(^Yu-1v\(bv'\v'\\n(^tu+1v-\\n(^Yu'\h'-|\\n(^lu+3n'
165 '\" # Special macro to handle page bottom: finish off current
166 '\" # box/sidebar if in box/sidebar mode, then invoked standard
167 '\" # page bottom macro.
174 .\" Draw three-sided box if this is the box's first page,
175 .\" draw two sides but no top otherwise.
176 .ie !\\n(^b-1 \h'-1.5n'\L'|\\n(^yu-1v'\l'\\n(^lu+3n\(ul'\L'\\n(^tu+1v-\\n(^yu'\h'|0u'\c
177 .el \h'-1.5n'\L'|\\n(^yu-1v'\h'\\n(^lu+3n'\L'\\n(^tu+1v-\\n(^yu'\h'|0u'\c
180 .nr ^x \\n(^tu+1v-\\n(^Yu
181 \kx\h'-\\nxu'\h'|\\n(^lu+3n'\ky\L'-\\n(^xu'\v'\\n(^xu'\h'|0u'\c
194 '\" # DS - begin display
200 '\" # DE - end display
206 '\" # SO - start of list of standard options
208 .SH "STANDARD OPTIONS"
214 '\" # SE - end of list of standard options
219 See the \\fBoptions\\fR manual entry for details on the standard options.
221 '\" # OP - start of full description for a single option
226 Command-Line Name: \\fB\\$1\\fR
227 Database Name: \\fB\\$2\\fR
228 Database Class: \\fB\\$3\\fR
232 '\" # CS - begin code excerpt
238 '\" # CE - end code excerpt
246 .TH Tk_ManageGeometry 3 4.0 Tk "Tk Library Procedures"
249 Tk_ManageGeometry \- arrange to handle geometry requests for a window
252 \fB#include <tk.h>\fR
254 \fBTk_ManageGeometry\fR(\fItkwin, mgrPtr, clientData\fR)
256 .AS Tk_GeometryProc clientData
257 .AP Tk_Window tkwin in
258 Token for window to be managed.
259 .AP Tk_GeomMgr *mgrPtr in
260 Pointer to data structure containing information about the
261 geometry manager, or NULL to indicate that \fItkwin\fR's geometry
262 shouldn't be managed anymore.
263 The data structure pointed to by \fImgrPtr\fR must be static:
264 Tk keeps a reference to it as long as the window is managed.
265 .AP ClientData clientData in
266 Arbitrary one-word value to pass to geometry manager callbacks.
271 \fBTk_ManageGeometry\fR arranges for a particular geometry manager,
272 described by the \fImgrPtr\fR argument, to control the geometry
273 of a particular slave window, given by \fItkwin\fR.
274 If \fItkwin\fR was previously managed by some other geometry manager,
275 the previous manager loses control in favor of the new one.
276 If \fImgrPtr\fR is NULL, geometry management is cancelled for
279 The structure pointed to by \fImgrPtr\fR contains information about
280 the geometry manager:
284 Tk_GeomRequestProc *\fIrequestProc\fR;
285 Tk_GeomLostSlaveProc *\fIlostSlaveProc\fR;
288 The \fIname\fR field is the textual name for the geometry manager,
289 such as \fBpack\fR or \fBplace\fR; this value will be returned
290 by the command \fBwinfo manager\fR.
292 \fIrequestProc\fR is a procedure in the geometry manager that
293 will be invoked whenever \fBTk_GeometryRequest\fR is called by the
294 slave to change its desired geometry.
295 \fIrequestProc\fR should have arguments and results that match the
296 type \fBTk_GeomRequestProc\fR:
298 typedef void Tk_GeomRequestProc(
299 ClientData \fIclientData\fR,
300 Tk_Window \fItkwin\fR);
302 The parameters to \fIrequestProc\fR will be identical to the
303 corresponding parameters passed to \fBTk_ManageGeometry\fR.
304 \fIclientData\fR usually points to a data
305 structure containing application-specific information about
306 how to manage \fItkwin\fR's geometry.
308 The \fIlostSlaveProc\fR field of \fImgrPtr\fR points to another
309 procedure in the geometry manager.
310 Tk will invoke \fIlostSlaveProc\fR if some other manager
311 calls \fBTk_ManageGeometry\fR to claim
312 \fItkwin\fR away from the current geometry manager.
313 \fIlostSlaveProc\fR is not invoked if \fBTk_ManageGeometry\fR is
314 called with a NULL value for \fImgrPtr\fR (presumably the current
315 geometry manager has made this call, so it already knows that the
316 window is no longer managed), nor is it called if \fImgrPtr\fR
317 is the same as the window's current geometry manager.
318 \fIlostSlaveProc\fR should have
319 arguments and results that match the following prototype:
321 typedef void Tk_GeomLostSlaveProc(
322 ClientData \fIclientData\fR,
323 Tk_Window \fItkwin\fR);
325 The parameters to \fIlostSlaveProc\fR will be identical to the
326 corresponding parameters passed to \fBTk_ManageGeometry\fR.
329 callback, geometry, managed, request, unmanaged