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.

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.

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