Herror ::set_window_attr (
    const HTuple &AttributeName,
    const HTuple &AttributeValue
)

Set window's characteristics.

You may use ::set_window_attr to set specific characteristics of graphical windows. With it you may modify 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 -> HTuple.char *
Name of the attribut, which has to be modified.
List of values: 'border_width', 'border_color', 'background_color', 'window_title'

AttributeValue (input_control)
string -> HTuple.char * / long
Value of the attribut, which has to be set.
List of values: 0, 1, 2, 'white', 'black', 'MyName', 'default'


Result

If the parameters are correct ::set_window_attr returns H_MSG_TRUE. If necessary an exception handling is raised.


Possible Predecessors

::open_window, ::set_draw, ::set_color, ::set_colored, ::set_line_width, ::open_textwindow


See also

::open_window


Module

System



Copyright © 1996-2002 MVTec Software GmbH