Detecting Whether a Menu Is Open

Last reviewed: July 23, 1997
Article ID: Q96427
3.10 WINDOWS kbprg

The information in this article applies to:

  • Microsoft Windows Software Development Kit (SDK) for Windows version 3.1

SUMMARY

With Windows version 3.1, an application can determine whether a menu is open in the system by calling the GetSystemDebugState function. An application can use this information to perform its tasks without interfering with the menu mechanism of Windows.

MORE INFORMATION

For example, if a background application displays a hidden pop-up window while a menu is open in some other application, the user who opened the menu will be confused. In this situation, the background application must check the menu state of the system before displaying its hidden pop-up window.

GetSystemDebugState function returns a LONG value that can be used to determine the menu state of the system. The function can be used as follows:

     if ( GetSystemDebugState() & SDS_MENU )
         // Yes! There is a menu open.
     else
         // No! There is no menu open.

For further information on the GetSystemDebugState function, please see page 445 of "Microsoft Windows Software Development Kit, Programmer's Reference, Volume 2: Functions" manual.


Additional reference words: 3.10
KBCategory: kbprg
KBSubcategory: UsrMen
Keywords : kb16bitonly


THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: July 23, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.