CWnd::RunModalLoop

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

int RunModalLoop(
   DWORD dwFlags = 0 
);

Parameters

  • dwFlags
    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.

Return Value

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

Remarks

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

Requirements

Header: afxwin.h

See Also

Concepts

CWnd Class

CWnd Members

Hierarchy Chart

CWnd::EndModalLoop

WM_ENTERIDLE