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 man­
       ager  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 particu­
       lar coordinates.  The position of the window may be offset
       by dimensions of the title bar added by  the  window  man­
       ager.

       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.

              update

              wm deiconify .top
              winop move .top 100 100


OPERATIONS

       The following operations are available for the winop  com­
       mand:

       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 con­
              tents 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  mes­
              sage 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

              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 loca­
              tion 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


Man(1) output converted with man2html