Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5d

Application v 5.25a

  

 

Chapter NineDialog Functions (continued)

ControlUpdate Function

Overview

The ControlUpdate function forces a control to update its status and paint.

Syntax/Parameters

Syntax

int = ControlUpdate ( int id, [boolean erase] );

Parameters

id

An int that identifies the dialog control to update.

erase

An optional boolean parameter that tells Windows to erase the background and start over with painting. This will remove any painting errors or artifacts but may also cause flicker when repeatedly called. In addition, repainting is an expensive operation with respect to processing.

Return Value

An int specifying ERROR_NONE (0) on success, ERROR_RANGE on bad control ID, or ERROR_INVALID_HANDLE.

Remarks

When performing long sequences of processing within a dialog, the action of setting control data may not update in a timely manner. This function forces an update.

This function can only be used within a dialog procedure. If a dialog page is not active, the function will fail.

Related Functions

Platform Support

Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL

Legato IDE, Legato Basic