### QPxObs_RedrawArea

QPxObs_RedrawArea(areaRef; redrawOpts):error
| areaRef | Longint | QPix area reference
| redrawOpts | Longint | Redraw options
| error | Longint | Error result

### Do not use this command in QPix v3 or later

This command is preserved in QPix v3 for backward compatibility reasons. There is no reason to force a plug-in area redraw in QPix v3 and later.

Forces a QPix plug-in area to be redrawn.

The QPix plug-in area is specified by areaRef. If areaRef is not a valid QPix plug-in area reference, qpx_paramErr is returned.

Passing qpx_UpdateBuffers in redrawOpts will also force update the area's offscreen buffer from the image source.

Note

- When a QPix plug-in area is used to display a 4D picture field (named the same as the area object with an underscore at the end), passing qpx_UpdateBuffers in redrawOpts will cause QPix to get the current value of the associated field and reload it.
- Under normal circumstances you will rarely need to use this command. It is required mostly when you change the drawing characteristics by directly accessing the area's internal graphics importer instance.

Example

`` ``Redraw area` `` `C_LONGINT($error)` `` `$error:=QPx_RedrawArea (gQPixArea)` `` `If ($error#qpx_noErr)` ``Handle the error` `End if`

QPix © Escape
Generated by QDoc 2.8 on Wed, Feb 17, 2010 17:47:04