GeomReq man page on SunOS

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
SunOS logo
[printable version]

Tk_GeometryRequest(3)	     Tk Library Procedures	 Tk_GeometryRequest(3)

______________________________________________________________________________

NAME
       Tk_GeometryRequest,  Tk_SetInternalBorder - specify desired geometry or
       internal border for a window

SYNOPSIS
       #include <tk.h>

       Tk_GeometryRequest(tkwin, reqWidth, reqHeight)

       Tk_SetInternalBorder(tkwin, width)

ARGUMENTS
       Tk_Window    tkwin	 (in)	   Window for which geometry is	 being
					   requested.

       int	    reqWidth	 (in)	   Desired  width  for tkwin, in pixel
					   units.

       int	    reqHeight	 (in)	   Desired height for tkwin, in	 pixel
					   units.

       int	    width	 (in)	   Space  to leave for internal border
					   for tkwin, in pixel units.
_________________________________________________________________

DESCRIPTION
       Tk_GeometryRequest is called by widget code to indicate its  preference
       for  the dimensions of a particular window.  The arguments to Tk_Geome‐
       tryRequest 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  Tk_Geome‐
       tryRequest,  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 ConfigureNotify event indicating that the geometry
       change has occurred.  Widget code should	 never	call  procedures  like
       Tk_ResizeWindow directly.  Instead, it should invoke Tk_GeometryRequest
       and leave the final geometry decisions to the geometry manager.

       If tkwin is a top-level window, then the geometry information  will  be
       passed to the window manager using the standard ICCCM protocol.

       Tk_SetInternalBorder is called by widget code to indicate that the wid‐
       get has an internal border.  This means that the widget draws a decora‐
       tive  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.  Width specifies the width of the border
       in pixels.  Geometry managers will use this information to avoid	 plac‐
       ing  any	 children  of  tkwin overlapping the outermost width pixels of
       tkwin's area.

       The information specified in calls to  Tk_GeometryRequest  and  Tk_Set‐
       InternalBorder	can   be   retrieved  using  the  macros  Tk_ReqWidth,
       Tk_ReqHeight, and Tk_InternalBorderWidth.  See the  Tk_WindowId	manual
       entry for details.

KEYWORDS
       geometry, request

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌────────────────────┬─────────────────┐
       │  ATTRIBUTE TYPE    │ ATTRIBUTE VALUE │
       ├────────────────────┼─────────────────┤
       │Availability	    │ SUNWTk	      │
       ├────────────────────┼─────────────────┤
       │Interface Stability │ External	      │
       └────────────────────┴─────────────────┘
NOTES
       Source for Tk is available in the SUNWTkS package.

Tk							 Tk_GeometryRequest(3)
[top]

List of man pages available for SunOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net