get_window ( : : : WindowID )

Query the current output window.

get_window returns the logical number of the current output window. Such a number is assigned to each window and is used to switch between several output windows. The window with the according number is set implicitly during opening of an output window (open_window, and open_textwindow) or explicitly by the procedure set_window.


Attention

After closing a window (close_window) not a single window is active. Calling get_window results in a error message.


Parameters

WindowID (output_control)
window.id -> integer
logical number of the current window.


Example
/* working with two windows */
open_window(::0,0,-1,-1,'root','','':) >
get_window(:::OldWindow) >
disp_image(Image:::) >
...
open_window(::0,0,-1,-1,'root','','':) >
get_window(:::WorkWindow) >
...
set_window(::OldWindow:) >
set_colored(::12:) >
disp_region(Regions:::). >

Result

If a window is activated, then get_window returns TRUE. If necessary an exception is raised.


Possible Predecessors

open_window, set_draw, set_color, set_colored, set_line_width, open_textwindow, set_window, disp_region


Possible Successors

set_window


See also

open_window, open_textwindow, set_window, close_window, close_all_windows



Copyright © 1996-1997 MVTec Software GmbH