ManageGeom.3
上传用户:rrhhcc
上传日期:2015-12-11
资源大小:54129k
文件大小:3k
- '"
- '" Copyright (c) 1990-1994 The Regents of the University of California.
- '" Copyright (c) 1994-1996 Sun Microsystems, Inc.
- '"
- '" See the file "license.terms" for information on usage and redistribution
- '" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
- '"
- '" RCS: @(#) $Id: ManageGeom.3,v 1.2 1998/09/14 18:22:52 stanton Exp $
- '"
- .so man.macros
- .TH Tk_ManageGeometry 3 4.0 Tk "Tk Library Procedures"
- .BS
- .SH NAME
- Tk_ManageGeometry - arrange to handle geometry requests for a window
- .SH SYNOPSIS
- .nf
- fB#include <tk.h>fR
- .sp
- fBTk_ManageGeometryfR(fItkwin, mgrPtr, clientDatafR)
- .SH ARGUMENTS
- .AS Tk_GeometryProc clientData
- .AP Tk_Window tkwin in
- Token for window to be managed.
- .AP Tk_GeomMgr *mgrPtr in
- Pointer to data structure containing information about the
- geometry manager, or NULL to indicate that fItkwinfR's geometry
- shouldn't be managed anymore.
- The data structure pointed to by fImgrPtrfR must be static:
- Tk keeps a reference to it as long as the window is managed.
- .AP ClientData clientData in
- Arbitrary one-word value to pass to geometry manager callbacks.
- .BE
- .SH DESCRIPTION
- .PP
- fBTk_ManageGeometryfR arranges for a particular geometry manager,
- described by the fImgrPtrfR argument, to control the geometry
- of a particular slave window, given by fItkwinfR.
- If fItkwinfR was previously managed by some other geometry manager,
- the previous manager loses control in favor of the new one.
- If fImgrPtrfR is NULL, geometry management is cancelled for
- fItkwinfR.
- .PP
- The structure pointed to by fImgrPtrfR contains information about
- the geometry manager:
- .CS
- typedef struct {
- char *fInamefR;
- Tk_GeomRequestProc *fIrequestProcfR;
- Tk_GeomLostSlaveProc *fIlostSlaveProcfR;
- } Tk_GeomMgr;
- .CE
- The fInamefR field is the textual name for the geometry manager,
- such as fBpackfR or fBplacefR; this value will be returned
- by the command fBwinfo managerfR.
- .PP
- fIrequestProcfR is a procedure in the geometry manager that
- will be invoked whenever fBTk_GeometryRequestfR is called by the
- slave to change its desired geometry.
- fIrequestProcfR should have arguments and results that match the
- type fBTk_GeomRequestProcfR:
- .CS
- typedef void Tk_GeomRequestProc(
- ClientData fIclientDatafR,
- Tk_Window fItkwinfR);
- .CE
- The parameters to fIrequestProcfR will be identical to the
- corresponding parameters passed to fBTk_ManageGeometryfR.
- fIclientDatafR usually points to a data
- structure containing application-specific information about
- how to manage fItkwinfR's geometry.
- .PP
- The fIlostSlaveProcfR field of fImgrPtrfR points to another
- procedure in the geometry manager.
- Tk will invoke fIlostSlaveProcfR if some other manager
- calls fBTk_ManageGeometryfR to claim
- fItkwinfR away from the current geometry manager.
- fIlostSlaveProcfR is not invoked if fBTk_ManageGeometryfR is
- called with a NULL value for fImgrPtrfR (presumably the current
- geometry manager has made this call, so it already knows that the
- window is no longer managed), nor is it called if fImgrPtrfR
- is the same as the window's current geometry manager.
- fIlostSlaveProcfR should have
- arguments and results that match the following prototype:
- .CS
- typedef void Tk_GeomLostSlaveProc(
- ClientData fIclientDatafR,
- Tk_Window fItkwinfR);
- .CE
- The parameters to fIlostSlaveProcfR will be identical to the
- corresponding parameters passed to fBTk_ManageGeometryfR.
- .SH KEYWORDS
- callback, geometry, managed, request, unmanaged