### ManageImageWindow

Category

Interface Control

Function

Allows Image or Display windows to be opened and closed from within a visual program.

Syntax

Available only in the user interface.

Inputs

Name | Type | Default | Description
--- | --- | --- | ---
`name` | string or string list | no default | name of the windows to be opened or closed
`open` | flag, flag list, or string list | 0 | 0: close the windows 1: open the windows
`how` | string | "title" | open or close the Image or Display windows by title, label, or window

Functional Details

`name` | specifies the windows to be opened.

`open`

determines whether the specified windows will be opened (1) or closed (0). The effect of this parameter depends on the type of argument supplied:

- If the argument is a single integer, all the specified windows will be opened or they will all be closed.
- If the argument is an integer list, it must have the same number of items as the list of strings given in `name`, and the flags are associated one-to-one with the named windows.
- If the argument is a string list, the windows listed in `open` will be opened, and those listed in `name` but not in `open` will be closed.

`how`

if specified, determines how the `name` parameter is to be interpreted:

"title" | the name specified is the title of the window (accessible through the `Image Name` option in the `Options` pull-down menu of the Image window, the `title` parameter of the Image tool or the `where` parameter of the Display module).
"label" | the name specified is the label of the window (accessible through the `Notation` field of the configuration dialog box of the Image or Display module).
"window" | the window identifier. If using SuperviseWindow and SuperviseState, then `name` should be the `where` output of SuperviseWindow.

Note: If you use this module to close a window, you must also turn off rendering to that window, using the Route module. Otherwise the window will open and then immediately close.

Example Visual Program InterfaceControl2.net

See Also Execute, ManageColormapEditor, ManageControlPanel, ManageSequencer, Route, SuperviseWindow, SuperviseState

[ OpenDX Home at IBM | OpenDX.org ]