set_window_attr ( : : AttributeName, AttributeValue : )

Set window characteristics.

You may use set_window_attr to set specific characteristics of graphics windows. With it you may modify the following default parameters of a window:

 'border_width'     Width of the window border in pixels.

 'border_color'     Color of the window border.

 'background_color' Background color of the window.

 'window_title'     Name of the window in the titlebar.


Attention

You have to call set_window_attr before calling open_window.


Parameters

AttributeName (input_control)
string -> string
Name of the attribute that should be modified.
List of values: 'border_width', 'border_color', 'background_color', 'window_title'

AttributeValue (input_control)
string -> string / integer
Value of the attribute that should be set.
List of values: 0, 1, 2, 'white', 'black', 'MyName', 'default'


Result

If the parameters are correct set_window_attr returns 2 (H_MSG_TRUE). If necessary an exception handling is raised.


Parallelization Information

set_window_attr is reentrant, local, and processed without parallelization.


Possible Predecessors

open_window, set_draw, set_color, set_colored, set_line_width, open_textwindow


See also

open_window, get_window_attr


Module

System



Copyright © 1996-2005 MVTec Software GmbH