通讯编程

开发平台：
Visual C++

GeomReq.3：源码内容
							'"
'" 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: GeomReq.3,v 1.3 2001/09/26 20:25:17 pspjuth Exp $
'" 
.so man.macros
.TH Tk_GeometryRequest 3 "8.4" Tk "Tk Library Procedures"
.BS
.SH NAME
Tk_GeometryRequest, Tk_SetMinimumRequestSize, Tk_SetInternalBorder, Tk_SetInternalBorderEx - specify desired geometry or internal border for a window
.SH SYNOPSIS
.nf
fB#include <tk.h>fR
.sp
fBTk_GeometryRequestfR(fItkwin, reqWidth, reqHeightfR)
.sp
fBTk_SetMinimumRequestSizefR(fItkwin, minWidth, minHeightfR)
.sp
fBTk_SetInternalBorderfR(fItkwin, widthfR)
.sp
fBTk_SetInternalBorderExfR(fItkwin, left, right, top, bottomfR)
.SH ARGUMENTS
.AS baseHeight clientData
.AP Tk_Window tkwin in
Window for which geometry is being requested.
.AP int reqWidth in
Desired width for fItkwinfR, in pixel units.
.AP int reqHeight in
Desired height for fItkwinfR, in pixel units.
.AP int minWidth in
Desired minimum requested width for fItkwinfR, in pixel units.
.AP int minHeight in
Desired minimum requested height for fItkwinfR, in pixel units.
.AP int width in
Space to leave for internal border for fItkwinfR, in pixel units.
.AP int left in
Space to leave for left side of internal border for fItkwinfR, in pixel units.
.AP int right in
Space to leave for right side of internal border for fItkwinfR, in pixel units.
.AP int top in
Space to leave for top side of internal border for fItkwinfR, in pixel units.
.AP int bottom in
Space to leave for bottom side of internal border for fItkwinfR, in pixel units.
.BE
.SH DESCRIPTION
.PP
fBTk_GeometryRequestfR is called by widget code to indicate its
preference for the dimensions of a particular window.  The arguments
to fBTk_GeometryRequestfR are made available to the geometry
manager for the window, which then decides on the actual geometry
for the window.  Although geometry managers generally try to satisfy
requests made to fBTk_GeometryRequestfR, there is no guarantee that
this will always be possible.  Widget code should not assume that
a geometry request will be satisfied until it receives a
fBConfigureNotifyfR event indicating that the geometry change has
occurred.  Widget code should never call procedures like
fBTk_ResizeWindowfR directly.  Instead, it should invoke
fBTk_GeometryRequestfR and leave the final geometry decisions to
the geometry manager.
.PP
If fItkwinfR is a top-level window, then the geometry information
will be passed to the window manager using the standard ICCCM protocol.
.PP
fBTk_SetInternalBorderfR is called by widget code to indicate that
the widget has an internal border.  This means that the widget draws
a decorative border inside the window instead of using the standard
X borders, which are external to the window's area.  For example,
internal borders are used to draw 3-D effects.  fIWidthfR
specifies the width of the border in pixels.  Geometry managers will
use this information to avoid placing any children of fItkwinfR
overlapping the outermost fIwidthfR pixels of fItkwinfR's area.
.PP
fBTk_SetInternalBorderExfR works like fBTk_SetInternalBorderfR
but lets you specify different widths for different sides of the window.
.PP
fBTk_SetMinimumRequestSizefR is called by widget code to indicate
that a geometry manager should request at least this size for the
widget.  This allows a widget to have some control over its size when
a propagating geometry manager is used inside it.
.PP
The information specified in calls to fBTk_GeometryRequestfR,
fBTk_SetMinimumRequestSizefR, fBTk_SetInternalBorderfR and
fBTk_SetInternalBorderExfR can be retrieved using the macros
fBTk_ReqWidthfR, fBTk_ReqHeightfR, fBTk_MinReqWidthfR,
fBTk_MinReqHeightfR, fBTk_MinReqWidthfR, fBTk_InternalBorderLeftfR,
fBTk_InternalBorderRightfR, fBTk_InternalBorderTopfR and
fBTk_InternalBorderBottomfR.
See the fBTk_WindowIdfR manual entry for details.
.SH KEYWORDS
geometry, request

						