tk_movetoplevelwindow(3tk) [opensolaris man page]

Tk_MoveToplevelWindow(3TK)				       Tk Library Procedures					Tk_MoveToplevelWindow(3TK)

__________________________________________________________________________________________________________________________________________________

NAME

       Tk_MoveToplevelWindow - Adjust the position of a top-level window

SYNOPSIS

       #include <tk.h>

       Tk_MoveToplevelWindow(tkwin, x, y)

ARGUMENTS

       Tk_Window   tkwin   (in)      Token for top-level window to move.

       int	   x	   (in)      New  x-coordinate	for  the  top-left pixel of tkwin's border, or the top-left pixel of the decorative border
				     supplied for tkwin by the window manager, if there is one.

       int	   y	   (in)      New y-coordinate for the top-left pixel of tkwin's border, or the top-left pixel  of  the	decorative  border
				     supplied for tkwin by the window manager, if there is one.
_________________________________________________________________

DESCRIPTION

       In  general,  a window should never set its own position;  this should be done only by the geometry manger that is responsible for the win-
       dow.  For top-level windows the window manager is effectively the geometry manager;  Tk provides interface code between the application and
       the  window manager to convey the application's desires to the geometry manager.  The desired size for a top-level window is conveyed using
       the usual Tk_GeometryRequest mechanism.	The procedure Tk_MoveToplevelWindow may be used by an application to request a particular position
       for a top-level window;	this procedure is similar in function to the wm geometry Tcl command except that negative offsets cannot be speci-
       fied.  It is invoked by widgets such as menus that want to appear at a particular place on the screen.

       When Tk_MoveToplevelWindow is called it doesn't immediately pass on the new desired location to the window manager;  it defers this  action
       until all other outstanding work has been completed, using the Tk_DoWhenIdle mechanism.

KEYWORDS

       position, top-level window, window manager

ATTRIBUTES

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

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTk	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES

       Source for Tk is available on http://opensolaris.org.

Tk															Tk_MoveToplevelWindow(3TK)

Tk_GeometryRequest(3TK) 				       Tk Library Procedures					   Tk_GeometryRequest(3TK)

__________________________________________________________________________________________________________________________________________________

NAME

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

SYNOPSIS

       #include <tk.h>

       Tk_GeometryRequest(tkwin, reqWidth, reqHeight)

       Tk_SetMinimumRequestSize(tkwin, minWidth, minHeight)

       Tk_SetInternalBorder(tkwin, width)

       Tk_SetInternalBorderEx(tkwin, left, right, top, bottom)

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	    minWidth	 (in)	   Desired minimum requested width for tkwin, in pixel units.

       int	    minHeight	 (in)	   Desired minimum requested height for tkwin, in pixel units.

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

       int	    left	 (in)	   Space to leave for left side of internal border for tkwin, in pixel units.

       int	    right	 (in)	   Space to leave for right side of internal border for tkwin, in pixel units.

       int	    top 	 (in)	   Space to leave for top side of internal border for tkwin, in pixel units.

       int	    bottom	 (in)	   Space to leave for bottom side of 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 information will be passed to the window manager using the standard 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 deco-
       rative 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 placing any children of tkwin overlapping the outermost width pixels of tkwin's area.

       Tk_SetInternalBorderEx works like Tk_SetInternalBorder but lets you specify different widths for different sides of the window.

       Tk_SetMinimumRequestSize 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.

       The  information specified in calls to Tk_GeometryRequest, Tk_SetMinimumRequestSize, Tk_SetInternalBorder and Tk_SetInternalBorderEx can be
       retrieved using the macros Tk_ReqWidth, Tk_ReqHeight, Tk_MinReqWidth, Tk_MinReqHeight, Tk_MinReqWidth, Tk_InternalBorderLeft,  Tk_Internal-
       BorderRight, Tk_InternalBorderTop and Tk_InternalBorderBottom.  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 | Uncommitted     |
       +--------------------+-----------------+
NOTES

       Source for Tk is available on http://opensolaris.org.

Tk									8.4						   Tk_GeometryRequest(3TK)