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‐
larities.
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 posi‐
tion 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 XRaiseWin‐
dow 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 win‐
dow. 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 coor‐
dinates. 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)
