get_window_attrget_window_attrGetWindowAttrGetWindowAttrget_window_attr (Operator)
Name
get_window_attrget_window_attrGetWindowAttrGetWindowAttrget_window_attr — Get window characteristics.
Signature
Description
The operator get_window_attrget_window_attrGetWindowAttrGetWindowAttrGetWindowAttrget_window_attr can be used to read
characteristics of graphics windows that were set using
set_window_attrset_window_attrSetWindowAttrSetWindowAttrSetWindowAttrset_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 title bar.
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 returned.
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 (output_control) string → HTupleUnion[str, int]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
Attribute value.
Result
If the parameters are correct get_window_attrget_window_attrGetWindowAttrGetWindowAttrGetWindowAttrget_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,
set_window_attrset_window_attrSetWindowAttrSetWindowAttrSetWindowAttrset_window_attr
Module
Foundation