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

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 coordinates.  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                                         blt::winop(3)