Description
Controls the automatic redrawing of an object or control after each change to its properties.
Applies to
Any object except a Menu
Syntax
objectname.SetRedraw ( boolean )
Return value
Integer.
Returns 1 if it succeeds and -1 if an error occurs. If boolean is null, SetRedraw returns null.
Usage
By default, PowerBuilder redraws a control after each change to properties that affect appearance. Use SetRedraw to turn off redrawing temporarily in order to avoid flicker and reduce redrawing time when you are making several changes to the properties of an object or control. If the window is not visible, SetRedraw fails.
Caution
If you turn redraw off, you must turn it on again. Otherwise, problems may result. In addition, if redraw is off and you change the Visible or Enabled property of an object in the window, the tabbing order may be affected.
Examples
This statement turns off redraw for lb_Location:
lb_Location.SetRedraw(FALSE)
If lb_Location is sorted (lb_Location.Sorted = TRUE), these statements use SetRedraw to avoid sorting and redrawing the list of lb_Location until all the new items have been added:
lb_Location.SetRedraw(FALSE)
lb_Location.AddItem("Atlanta")
lb_Location.AddItem("Boston")
lb_Location.AddItem("Washington")
lb_Location.SetRedraw(TRUE)