Window(3X) manual page
Table of Contents
ApplicationWindow, IconWindow, ManagedWindow, PopupWindow,
TopLevelWindow, TransientWindow - window classes and window manager interactions
#include <ivplus/window.h>
Window is an abstract base class
that encapsulates the methods and data of the underlying X windows used
by all interactors.
ManagedWindow is an abstract base class that extends
the Window class to include interactions with Inter-Client Communications
Conventions Manual (ICCCM
) compliant window managers.
ApplicationWindow
is a class that is used for the application’s main window.
IconWindow is
a class that handles iconified windows.
PopupWindow is a class that does
not interact with the window manager, so it is derived from the Window
class directly.
TopLevelWindow is a class that manages top level windows
of the application other than the main window.
TransientWindow is a class
that handles application windows that are meant to be temporary, such as
dialog boxes. These windows will normally iconify along with an associated
top level or main window.
A pointer to the ManagedWindow object associated
with a top level interactor is returned by the Interactor operation GetTopLevelWindow().
ApplicationWindow -> ManagedWindow -> Window
IconWindow -> ManagedWindow -> Window
PopupWindow -> Window
TopLevelWindow -> ManagedWindow -> Window
TransientWindow -> TopLevelWindow -> ManagedWindow -> Window
Since Window and ManagedWindow
are abstract base classes, their constructors are protected.
All
of the constructors take a Glyph* parameter. In InterViews Plus, these windows
are always associated with an Interactor object. Interactor is derived
from Glyph.
Window class operations:
Used in determining the size and placement of the window.
Binds the current window description to its X window counterpart,
creating the X window if necessary.
Returns
the coordinate corresponding to the bottom edge of the window.
Returns whether this window is bound. See bind() and unbind().
Returns the Canvas object associated with
this window.
Sets the cursor to be used when
the mouse pointer is within the window’s borders.
Returns the cursor to be used when the mouse pointer is within the
window’s borders.
Sets the Display object associated
with this window.
Returns the Display object
associated with this window.
Returns a pointer
to the glyph associated with this window.
Grabs
the keyboard. Any keyboard events (including FocusIn and FocusOut events)
are sent to this window regardless of where the keyboard focus was previously.
To release the grab, use ungrab_keyboard().
Grabs the mouse pointer, optionally setting the cursor to be
displayed during the grab. Any mouse events normally received by this window
will be sent to it regardless of the location of the mouse pointer. To release
the grab, use ungrab_pointer().
Returns
whether or not this window is currently mapped.
Returns
whether or not this window is associated with an Interactor object.
Returns the coordinate corresponding to the left
edge of the window.
Lowers this window with respect
to the other windows on the display.
Maps the window to
the display.
Moves
the window to the indicated lower left coordinate.
Returns the height of the window in pixels.
Sets the lower left coordinate
of the window with respect to the World.
Sets the lower left coordinate of the window with respect
to the World.
Pushes the current cursor onto the
cursor stack.
Pops the last cursor from the cursor
stack.
Raises this window with respect to the other
windows on the display.
Looks at an event
that has been received for this window. Handles map, expose, and configure
events.
Returns a pointer to the WindowRep associated
with this window. The WindowRep is a low-level X interface and would not
normally be accessed. It is, therefore, not documented further.
Causes any damaged area to be redrawn.
Causes
the window to resize itself.
Returns
the Handler associated with the event’s target. For events that have no associated
pointer location, it returns nil.
Sets the Style
object for this window.
Returns the Style object associated
with this window.
Unbinds the window from its X window
counterpart, removing the window from the window table. X will automatically
destroy subwindows, so there is no need to destroy the window if it has
a parent.
Ungrabs the keyboard. See
grab_keyboard().
Ungrabs the mouse pointer.
See grab_pointer().
Unmaps the window from the display.
ManagedWindow class operations:
Deiconifies this
window.
Sets the Display object associated
with this window.
Returns the Display object
associated with this window.
Sets handlers for FocusIn and FocusOut events.
Sets
a pointer to the ManagedWindow object that is used to display this window’s
icon.
Returns a pointer to the ManagedWindow
object that is used to display this window’s icon.
Iconifies
the window.
Sets the Bitmap object used
when this window is iconified.
Returns
the Bitmap object used when this window is iconified.
Sets
the Bitmap object used as a mask when this window is iconified.
Returns the Bitmap object used as a mask when
this window is iconified.
Returns a pointer
to the WindowRep associated with this Window. The ManagedWindowRep is a
low-level X interface and would not normally be accessed. It is, therefore,
not documented further.
Causes the window to resize
itself.
Sets the handler to be called when
a window manager delete signal is received.
TopLevelWindow class operations:
Sets this window’s group leader
to primary.
Returns this window’s group
leader.
TransientWindow class operations:
Sets
a pointer to the window which will act as this windows group leader. When
the group leader is iconified, this window will also iconify. It is not
possible to position this window behind its group leader.
Returns a pointer to the window which will act as
this windows group leader. When the group leader is iconified, this window
will also iconify. It is not possible to position this window behind its
group leader.
Window class operations:
Calculates the size and placement of the window. By default,
this operation does nothing.
Sets specific attributes
for this window. By default, this operation does nothing.
Calculates
the size and placement of the window. By default, this operation does nothing.
Causes the window to be raised, mapping it to the
display.
Sets common X window attributes such
as the event mask, color map, and cursor.
Sets window
manager properties.
ManagedWindow class operations:
Calculates
the size and placement of the window. By default, this operation does nothing.
Sets window manager properties.
Application class
operations:
Calculates the size and placement
of the window. By default, this operation does nothing.
Sets
window manager properties.
TopLevelWindow class operations:
Sets window manager properties.
TransientWindow class operations:
Sets specific attributes for this window. By default,
this operation does nothing.
Sets common X
window attributes such as the event mask, color map, and cursor.
PopupWindow
class operations:
Sets common X window attributes
such as the event mask, color map, and cursor.
IconWindow class operations:
Overrides Window::do_map(). This operation does nothing.
None.
None.
window.h
Interactor(3X)
, World(3X)
.
Table of Contents
![[Go to CFHT Home Page]](/images/cfht-icon.gif){kind=icon}
Man Pages 
Back to Software Index 
Manpage Top Level