get_window_attr ( : : AttributeName : AttributeValue )

Get window characteristics.

The operator get_window_attr can be used to read characteristics of graphics windows that were set using set_window_attr. The following parameters of a window may be queried:

 '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.


Parameters

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

AttributeValue (output_control)
string -> string / integer
Attribute value.


Result

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


Parallelization Information

get_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, set_window_attr


Module

System



Copyright © 1996-2005 MVTec Software GmbH