Tk_SetInternalBorder man page on BSDOS

Man page or keyword search:  
man Server   6284 pages
apropos Keyword Search (all sections)
Output format
BSDOS 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 geom-
					   etry	     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_GeometryRequest 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_GeometryRequest,  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 informa-
       tion  will be passed to the window manager using the stan-
       dard ICCCM protocol.

       Tk_SetInternalBorder 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

Tk								1

Tk_GeometryRequest(3) Tk Library Procedures Tk_GeometryRequest(3)

       external to the window's area.  For example, internal bor-
       ders  are  used	to draw 3-D effects.  Width specifies the
       width of the border in pixels.  Geometry managers will use
       this  information  to  avoid placing any children of tkwin
       overlapping the outermost width pixels of tkwin's area.

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

KEYWORDS
       geometry, request

Tk								2

[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server BSDOS

List of man pages available for BSDOS

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