Function DispBegin() Foundation
Initiates the buffering of screen output.
DispBegin() --> NIL
The return value of DispBegin() is always NIL.
DispBegin() starts the buffering of screen output. Display is suppressed and temporarily stored until the function DispEnd() is called. After DispEnd() the buffers are displayed on the screen. When an Xbase++ application runs in a window, the buffering extends only to the active window and not the entire screen.
DispBegin() is always used with DispEnd(). A display on the screen is held in a buffer until the buffer is released with DispEnd(). This allows accelerated screen updating, especially with complex screen output.
For normal display operations the functions DispBegin() / DispEnd() are not needed. Their use is optional.
Calls to the function DispBegin() can be nested. If DispBegin() is called before the function DispEnd(), the internal counter of the function DispCount() is incremented. Buffered screen output occurs until a corresponding number of DispEnd() calls are made. Only then is the output visible on the screen.
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.