Vcl.Forms.TApplication.HandleMessage

• Up to Parent: TApplication

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

• OnIdle

• ProcessMessages

• UpdateAction

Code Examples

• HandleMessageExample (Delphi)
• HandleMessage (C++)