set_window_attrset_window_attrSetWindowAttrSetWindowAttrset_window_attr (Operator)
Name
set_window_attrset_window_attrSetWindowAttrSetWindowAttrset_window_attr — Set window characteristics.
Signature
Description
You may use set_window_attrset_window_attrSetWindowAttrSetWindowAttrSetWindowAttrset_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.
Is not implemented under Windows.
- 'border_color'
Color of the window border.
Is not implemented under Windows.
- 'background_color'
Background color of the window.
- 'window_title'
Name of the window in the title bar.
Attention
You have to call set_window_attrset_window_attrSetWindowAttrSetWindowAttrSetWindowAttrset_window_attr before
calling open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
AttributeNameAttributeNameAttributeNameAttributeNameattributeNameattribute_name (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name of the attribute that should be modified.
List of values: 'background_color'"background_color""background_color""background_color""background_color""background_color", 'border_color'"border_color""border_color""border_color""border_color""border_color", 'border_width'"border_width""border_width""border_width""border_width""border_width", 'window_title'"window_title""window_title""window_title""window_title""window_title"
AttributeValueAttributeValueAttributeValueAttributeValueattributeValueattribute_value (input_control) string → HTupleUnion[str, int]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
Value of the attribute that should be set.
List of values: 0, 1, 2, 'MyName'"MyName""MyName""MyName""MyName""MyName", 'black'"black""black""black""black""black", 'default'"default""default""default""default""default", 'white'"white""white""white""white""white"
Result
If the parameters are correct set_window_attrset_window_attrSetWindowAttrSetWindowAttrSetWindowAttrset_window_attr returns 2 (H_MSG_TRUE).
If necessary an exception is raised.
Possible Predecessors
open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window,
set_drawset_drawSetDrawSetDrawSetDrawset_draw,
set_colorset_colorSetColorSetColorSetColorset_color,
set_coloredset_coloredSetColoredSetColoredSetColoredset_colored,
set_line_widthset_line_widthSetLineWidthSetLineWidthSetLineWidthset_line_width
See also
open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window,
get_window_attrget_window_attrGetWindowAttrGetWindowAttrGetWindowAttrget_window_attr,
set_window_paramset_window_paramSetWindowParamSetWindowParamSetWindowParamset_window_param
Module
Foundation