Modifies the attributes of an existing window.
set_window( [id,] attributes)
-
id - an optional ChipsId structure containing values to
modify the currency state for the command or a string id to
modify the specified window.
-
o) attributes - optional parameters which allow the user to
configure properties of the window though a window attribute
object, user-defined object, list, dictionary, or
attribute string.
The set_window command sets the specified attributes to the
provided values. The modified window becomes current. Multiple
windows may be modified with a single command by setting the
currency to "all".
There are several attributes that control the characteristics
of windows. The set_window command may be used to modify
the attribute values of an existing window at any time during a
ChIPS session. See
"ahelp attributes"
and
"ahelp setget"
for more general information.
If multiple attributes are being set simultaneously and one of
them fails, the entire command will fail and the window will
not be modified.
The attributes associated with windows are:
| bgcolor |
Background Color of the window |
name or hex; see the Color section of
"ahelp chipsopt"
|
default: black in the ChIPS window, white on printout |
Note that the window title is not included in the attributes.
To set the title, use the set_window_title command.
Certain window properties, such as height and width, can
not be modified after the window is created. See
"ahelp add_window"
for more details on setting these properties.
The module of advanced ChIPS functions contains other commands
for setting attribute values (refer to "ahelp chips" for
information on loading the module):
set_window_bgcolor
set_window_redraw
set_window_redraw is a boolean
(see the Booleans section of "ahelp chipsopt")
that determines whether the window is updated as each command
is executed. The default value is "True".
chips> add_window()
chips> set_window(["bgcolor", "blue"])
Using an attribute/value pair, set the window background
color to blue.
chips> add_window(settings)
chips> settings = ChipsWindow()
chips> settings.bg.color = "blue"
chips> set_window (settings)
Using a ChIPS window attribute object, set the window
background color to blue.
chips> add_window(5, 8, "inches", ["bgcolor", "navy"])
chips> set_window("bgcolor=green")
Add a window with a navy background, then use a list to
change it to green.
|
![[ChIPS Logo]](../imgs/chips_logo_navbar.gif){kind=logo}