doWindowEvents

doWindowEvents(waitTime: Integer);

The doWindowEvents method of the Window class processes all pending Windows events for this window and all of its children.

The doWindowEvents method for a control processes events generated by the control and its children. In addition, it processes copies of the gotFocus, lostFocus, keyDown, keyUp, and keyPress events on the control, which are also sent to the form.

When the doWindowEvents method has processed all pending Windows events it then waits, and processes any further Windows events that arrive for this window until the specified time from when the method was initiated has expired.

Use the waitTime parameter to specify in milliseconds the required interval this method is to wait.

The most common use of this method is to enable a Cancel button to be monitored during lengthy processing. (See also the Application class doWindowEvents method.)

The methods in the following examples show the use of the doWindowEvents method.

btnCancel_click(btn: Button);
begin
    cancelWasClicked := true;
end;

longProcess() updating;
begin
    cancelWasClicked := false;
    while true do
        ...                            // some kind of processing
        btnCancel.doWindowEvents(0);   // allow button press
        if cancelWasClicked then
            ...                        // cancel processing
            break;
        endif;
    endwhile;
end;

Do not use the doWindowEvents method in the following situations.

• When causing a repaint of a window. Use the refreshNow method to repaint a window.

• When involved in the processing of ActiveX controls and OLE objects. As the OLE control processes requests synchronously using Window events, the Window class doWindowEvents method can cause asynchronous processing to be attempted, with resulting failure.

Call the Application class doWindowEvents method from a server method to process server notifications and timers.