ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
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.
Caution: If there are automatic calculations is to be displayed in Table controls, these calculations are not performed when the DisplayEnabled property is set to False. For more details, see the Remarks.
Example
// Add 1000 elements to a Table control
// The Table control is not refreshed after each addition
TABLE_TABLE1.DisplayEnabled = False
// Add
I is int
FOR I = 1 TO 1000
TableAdd(TABLE_TABLE1, MyCalculationRowContent(I))
END
// Refresh the Table control
TABLE_TABLE1.DisplayEnabled = 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.
  • Use example: 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.
Minimum version required
  • Version 9
Comments
Click [Add] to post a comment

Last update: 02/27/2023

Send a report | Local help