man page(1) manual page
Table of Contents

_________________________________________________________________

NAME

winop - Perform assorted window operations

SYNOPSIS

winop lower ?window?...

winop map ?window?...

winop raise ?window?...

winop unmap ?window?...

winop warpto ?window?
_________________________________________________________________

DESCRIPTION

The winop command performs assorted window operations on Tk windows using Xlib functions.

INTRODUCTION

Tk has several commands for manipulating its windows: raise, lower, wm, etc. Sometimes, interactions with particular window managers prevent the normal operation of these commands.

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

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


Table of Contents