DisplayEnabled (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Properties associated with windows, pages and controls

DisplayEnabled (Property)

In french: AffichageActif

The DisplayEnabled property is used to:

determine whether or not a control or window is refreshed. If the control is displayed, its content is refreshed regularly.
refresh a control or window.

This property optimizes the processes in which one or more controls must be used. The control or window is refreshed once it has been handled.

Warning: If Table controls display the results of automation calculations, these calculations will not be performed if the property ActiveDisplay property is set to False. For more details, see the Remarks.

Example

// Ajout de 1000 éléments dans un champ Table
// Le champ Table n'est plus ré-affiché à chaque ajout
TABLE_TABLE1.AffichageActif = False
// Ajout
I is int
FOR I = 1 TO 1000
	TableAdd(TABLE_TABLE1, MonCalculContenuLigne(I))
END
// Activation de l'affichage du champ Table
TABLE_TABLE1.AffichageActif = True

Syntax

Getting the current display mode Hide the details

<Result> = <Element used>.DisplayEnabled

<Result>: Boolean

True if the element is set to be refreshed,
False otherwise.

<Element used>: Control name or window name

Name of the control or window to be used.

Changing the current display mode Hide the details

<Element used>.DisplayEnabled = <Display mode>

<Element used>: Control or window name

Name of the control or window to be used.

<Display mode>: Boolean

True to refresh the element,
False to avoid refreshing the element.

Remarks

The DisplayEnabled property must never remain set to False. This value must be temporary (when populating a Table control, for example). Otherwise, an unexpected behaviour may occur (Windows uses 100% of the processor to refresh the control even though it is not being refreshed).
The DisplayEnabled property cannot be used on container controls such as Internal Window controls.
Example of use: Table control:
When the DisplayEnabled property is set to False, values are not calculated or displayed in the Table control. For example, this property allows users to add or delete elements without refreshing or re-calculating the Table control. Adding elements is faster and display effects are ignored, since neither the display nor the automatic calculation processes are executed. The DisplayEnabled property must be set back to True once these operations are completed.