CWnd::OnEnterIdle

Syntax

afx_msg void OnEnterIdle( UINT nWhy, CWnd* pWho );

Parameters

nWhy

Specifies whether the message is the result of a dialog box or a menu being displayed. This parameter can be one of the following values:

Value Description

MSGF_DIALOGBOX The system is idle because a dialog box is being displayed.
MSGF_MENU The system is idle because a menu is being displayed.

pWho

Specifies a pointer to the dialog box (if nWhy is MSGF_DIALOGBOX), or the window containing the displayed menu (if nWhy is MSGF_MENU). This pointer may be temporary, and should not be stored for later use.

Remarks

A call to OnEnterIdle informs an application's main window procedure that a modal dialog box or a menu is entering an idle state. A modal dialog box or menu enters an idle state when no messages are waiting in its queue after it has processed one or more previous messages.

This message-handler member function calls the Default member function. Override this member function in your derived class to handle the WM_ENTERIDLE message.

See Also

CWnd::Default, WM_ENTERIDLE