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