Vcl.Forms.TApplication.HandleMessage

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

procedure HandleMessage;

C++

void __fastcall HandleMessage();

Properties

Type Visibility Source Unit Parent
procedure
function
public
Vcl.Forms.pas
Vcl.Forms.hpp
Vcl.Forms TApplication

Description

Interrupts the execution of an application while Windows processes a message in the Windows message queue.

HandleMessage interrupts the execution of the application so that Windows can process a single message from the Windows message queue before returning control to the application. If the message queue is empty, HandleMessage generates an OnIdle event and starts the process of updating the actions in the application.

Note: If the application goes idle, HandleMessage may take a long time to return. Therefore, do not call HandleMessage when waiting for something message-based while priority actions are also being processed. Instead, call ProcessMessages when processing more than just messages.

See Also

Code Examples