BrightSign Object Reference Manual (FW 5.1) - Manual (Page 63)

55
o When this function is enabled, each call to SetLayer, ClearLayer, or Clear results in a redraw. If you
need to change multiple layers, then you should disable auto redraw while calling the SetLayer function.
o SetLayer enables or disables redrawing of the widget when layer content is changed. When auto-redraw is
enabled, each call to SetLayer, ClearLayer, or Clear results in a redraw. To batch multiple updates
together, you should first suspend drawing using EnableAutoRedraw(false), then make the changes to
the content, and finally re-enable drawing using EnableAutoRedraw(true). The redraw happens in a
separate thread, so EnableAutoRedraw returns almost immediately.
Object Content
The content specified in each layer can consist of one or more objects. Each object is defined by an roAssociativeArray .
If there is more than one object, then each is placed into an roArray prior to passing to the SetLayer function. Currently,
there are four object types:
1. Background color
• color: The #[aa]rrggbb hex value of the background color
• targetRect: A target rectangle, which is another roAssociativeArray consisting of x, y, w, and h values. These
values are relative to the top left corner of the widget.
2. Text
• text: A string of text to display
• targetRect: The rectangle in which the text is displayed
• textAttrs: An roAssociativeArray containing attributes to be applied to the text. The attributes can be any of the
following: