Method XbpWindow():lockUpdate() Foundation
Suppresses automatic screen updates.
:lockUpdate( <lLock> ) --> lSuccess
The method retuns a logical value indicating whether or not the desired screen-update mode could be set.
This method is used to temporarily suppress the automatic screen update of Xbase Parts. This is advantageous, for example, when a complex dialog window is resized and contained dialog elements must be repositioned. If the automatic screen update is switched off by calling :lockUpdate(.T.), the calculation can be done faster and the entire dialog window can be displayed at once. This is achieved by calling :lockUpdate(.F.) and :invalidateRect() when the operation is complete. As a result, the program reacts faster.
Another example is the creation of XbpTreeView or XbpListBox objects having many items. If the screen update is suppressed while single items are transferred to the object using :addItem(), single items are not drawn. Instead, the object can be displayed when all items are added.
If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.