Shiny Language Reference

Language Reference > Handler Reference


Render

 

 

Called to draw the plugin's display

This is probably the most important handler for a plugin. This is the only handler where drawing functions (text display, line drawing, image drawing etc) are valid. You should write all of your drawing code in this handler.

Brass calls this handler whenever an update to the plugin display panel is required (for example, because a window that was covering the panel has been moved away). You should not perform an infinite loop or try to second-guess when this handler should be called. Do not under any circumstances call this handler directly from another part of your plugin code - Brass must always call the handler for you. To request Brass to make this call use the redraw function.

Remember that this handler may be called repeatedly and constantly for periods of time. Therefore you should make your handler code as fast and as small as possible. Do not perform lengthy operations in the Render handler, instead use other handlers (such as Update). If you "stall" (cause Brass to wait on your handler to finish), you will cause delays in the update of your display panel. Standard Windows coding practices apply.

 

Parameters

None