This documentation is archived and is not being maintained.


Call this member function to retrieve, translate, or dispatch messages until ContinueModal returns FALSE.

int RunModalLoop( 
   DWORD dwFlags = 0  


Specifies the Windows message to be sent. Can be one of the following values:

  • MLF_NOIDLEMSG   Don't send WM_ENTERIDLE messages to the parent.

  • MLF_NOKICKIDLE   Don't send WM_KICKIDLE messages to the window.

  • MLF_SHOWONIDLE   Show the window when message queue goes idle.

Specifies the value of the nResult parameter passed to the EndModalLoop member function, which is then used to end the modal loop.

By default, ContinueModal returns FALSE after EndModalLoop is called. Returns the value provided as nResult to EndModalLoop.

Header: afxwin.h