SetRedraw

Description

Controls the automatic redrawing of an object or control after each change to its properties.

Applies to

DataWindow type	Method applies to
PowerBuilder	DataWindow control

Syntax

PowerBuilder

integer objectname.SetRedraw ( boolean redraw )

Argument	Description
objectname	The name of the object or control for which you want to change the redraw setting.
redraw	A boolean value that controls whether PowerBuilder redraws an object automatically after a change. Values are: True – Automatically redraw the object or control after each change to its properties. False – Do not redraw after each change.

Argument

Description

objectname

The name of the object or control for which you want to change the redraw setting.

redraw

A boolean value that controls whether PowerBuilder redraws an object automatically after a change. Values are:

True – Automatically redraw the object or control after each change to its properties.
False – Do not redraw after each change.

Returns

Returns 1 if it succeeds and –1 if an error occurs. If redraw 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.

PowerBuilder environment Inherited from DragObject. For more details on use with PowerBuilder objects, see SetRedraw in the PowerScript Reference.