DOCERR: WM_ENTERIDLE Documentation Is Misleading
PSS ID Number: Q102446
Article last modified on 07-27-1994

3.10

WINDOWS NT


----------------------------------------------------------------------
The information in this article applies to:

 - Microsoft Win32 Software Development Kit (SDK) for Windows NT
   version 3.1
----------------------------------------------------------------------

The Win32 application programming interface (API) online documentation
for the WM_ENTERIDLE message states the following:

   The WM_ENTERIDLE message informs an application's main window
   procedure that a modal dialog box or menu is entering an idle
   state.

This is incorrect for dialog boxes. The WM_ENTERIDLE message is sent to the
dialog box's owner window rather than the application's main window as the
documentation states.

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.

The Win32 SDK, version 3.5 documentation has been corrected.

Additional reference words: 3.10
KBCategory: Prg
KBSubcategory: UsrMisc

=============================================================================

Copyright Microsoft Corporation 1994.
