winop(n)						       BLT Built-In Commands							  winop(n)

__________________________________________________________________________________________________________________________________________________

NAME

       winop - Perform assorted window operations

SYNOPSIS

       winop lower ?window?...

       winop map ?window?...

       winop move window x y

       winop raise ?window?...

       winop snap window photoName

       winop unmap ?window?...

       winop warpto ?window?
_________________________________________________________________

DESCRIPTION

       The  winop command performs various window operations on Tk windows using low-level Xlib function calls to work around window manager pecu-
       liarities.

INTRODUCTION

       Tk has several commands for manipulating its windows: raise, lower, wm, etc.  These commands ask the window manager to  perform	operations
       on Tk windows.  In some cases, a particular window manager won't perform the operation as expected.

       For  example,  if  you positioned a toplevel window using wm geometry, the window may not actually be at those particular coordinates.  The
       position of the window may be offset by dimensions of the title bar added by the window manager.

       In situations like these, the winop command can be used	to  workaround	these  difficulties.   Instead,  it  makes  low-level  Xlib  (such
       XRaiseWindow and XMapWindow) calls to perform these operations.

	      toplevel .top
	      wm withdraw .top

	      # Set the geometry to make the window manager
	      # place the window.
	      wm geometry .top +100+100

	      # Move the window to the desired location
	      # and "update" to force the window manager
	      # to recognize it.
	      winop move .top 100 100
	      update

	      wm deiconify .top
	      winop move .top 100 100

OPERATIONS

       The following operations are available for the winop command:

       winop lower ?window?...
	      Lowers window to the bottom of the X window stack.  Window is the path name of a Tk window.

       winop map ?window?...
	      Maps window on the screen.  Window is the path name of a Tk window. If window is already mapped, this command has no effect.

       winop move window x y
	      Move  window  to	the screen location specified by x and y. Window is the path name of a Tk window, while x and y are screen coordi-
	      nates.  This command returns the empty string.

       winop raise ?window?...
	      Raises window to the top of the X window stack. Window must be a valid path name of a Tk window.	This  command  returns	the  empty
	      string.

       winop snap window photoName
	      Takes  a	snapshot  of the window and stores the contents in the photo image photoName. Window is the valid path name of a Tk window
	      which must be totally visible (unobscured).  PhotoName is the name of a Tk photo image which must already exist.	This  command  can
	      fail  if	the  window  is obscured in any fashion, such as covered by another window or partially offscreen.  In that case, an error
	      message is returned.

       winop unmap ?window?...
	      Unmaps window from the screen. Window is the path name of a Tk window.

       winop warpto ?window?
	      Warps the pointer to window. Window is the path name of a Tk window which must be mapped. If window is in the form @x,y, where x and
	      y are root screen coordinates, the pointer is warped to that location on the screen.

	      [I've  never  heard  a good case for warping the pointer in an application.  It can be useful for testing, but in applications, it's
	      always a bad idea.  Simply stated, the user owns the pointer, not the application.  If you have an application that  needs  it,  I'd
	      like to hear about it.]

	      If  no window argument is present the current location of the pointer is returned. The location is returned as a list in the form "x
	      y", where x and y are the current coordinates of the pointer.

KEYWORDS

       window, map, raise, lower, pointer, warp

BLT
									2.4								  winop(n)