current_window

Synopsis

Set the specified window as current.

current_window( ChipsId )
current_window( "window_id" )
current_window( "all" )

Description

The current_window command sets the window indicated by the argument as the current window; see "ahelp currency" for general information on currency.

• ChipsId - an optional ChipsId structure containing values to modify the currency state for the command.
• window_id - identification tag given to each object that is created; use this to select a specific window.
• all - sets all windows to be current.

Use the info_current command to retrieve a list of all the current items in the ChIPS session, as shown in Example 1.

Example 1

chips> id = ChipsId()
chips> add_window()
chips> add_window( "id=M33")
chips> id.window = "win1"
chips> current_window(id)
chips> info_current()

Two windows are created; the second window is current after it is created. The id.window command sets the window value of the ChipsId structure to the first window, which has the id "win1" by default. The current_window command makes that window current.

The output of info_current for this session is:

Window [win1]

Example 2

chips> add_window("id=M31")
chips> add_window()
chips> current_window("M31")

Two windows are created. After the second window is created, it is current. The current_window command then sets the first window as the current window.

Example 3

chips> add_window("id=M31")
chips> add_window()
chips> current_window("all")

Two windows are created. After the second window is created, it is current. The current_window command then makes all windows current.

Bugs

See the bugs pages on the ChIPS website for an up-to-date listing of known bugs.

See Also

concepts

chipsid, currency

utilities

clear

windows

add_window, deiconify_window, delete_window, get_window, iconify_window, print_window, set_window