windows_programming_notes.nbk: Home | Index | Next Page: WM_ENTERMENULOOP | Previous Page: WM_ENDSESSION

 WM_ENTERIDLE

The WM_ENTERIDLE message is sent to the owner window of a modal dialog box or menu that 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.

A window receives this message through its WindowProc function.

    LRESULT CALLBACK WindowProc(
      HWND hwnd,       // handle to window
      UINT uMsg,       // WM_ENTERIDLE
      WPARAM wParam,   // idle reason
      LPARAM lParam    // handle to dialog box or owner (HWND)
    );

Parameters

• wParam
  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 Meaning
  • MSGF_DIALOGBOX The system is idle because a dialog box is displayed.
  • MSGF_MENU The system is idle because a menu is displayed.
• lParam
  Handle to the dialog box (if wParam is MSGF_DIALOGBOX) or window containing the displayed menu (if wParam is MSGF_MENU).

Return Values

An application should return zero if it processes this message.

Remarks

You can suppress the WM_ENTERIDLE message for a dialog box by creating the dialog box with the DS_NOIDLEMSG style.

Requirements

• Windows NT/2000 or later: Requires Windows NT 3.1 or later.
• Windows 95/98/Me: Requires Windows 95 or later.
• Header: Declared in Winuser.h; include Windows.h.

windows_programming_notes.nbk: Home | Index | Next Page: WM_ENTERMENULOOP | Previous Page: WM_ENDSESSION

Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time