FIX: Undocking Toolbar May Disappear When Removed from Dockbar

Last reviewed: September 18, 1997
Article ID: Q134283
2.00 WINDOWS NT kbprg kbbuglist kbfixlist

The information in this article applies to:

  • The Microsoft Foundation Classes (MFC) included with: Microsoft Visual C++, 32-bit Edition, version 2.0

SYMPTOMS

Attempting to undock or tear off a toolbar window from its dockbar window occasionally causes the toolbar to disappear when the mouse button is released.

CAUSE

This is caused by a bug in the MFC source code for CFrameWnd::CanDock(). Essentially, what happens is that the toolbar is being docked to an invisible dockbar. The CFrameWnd::CanDock() function doesn't check to see if the new docbar window is visible.

When you float a toolbar, and then close it by double-clicking the tiny control menu or icon, the window is not destroyed; it is just hidden. If you happen to drag and release another toolbar over the hidden toolbar, the toolbar being dragged is docked to the hidden toolbar.

RESOLUTION

To work around this problem, rebuild the project with Visual C++ version 2.1. If that is not an option for you, you can work around the problem by modifying the WINFRM2.CPP MFC source file and rebuilding the appropriate MFC library.

NOTE: Microsoft recommends against rebuilding the MFC30(D).DLL (the MFC Shared DLL). MFC30(D).DLL is a common component of many MFC applications. Rebuilding MFC30(D).DLL runs the risk of breaking other applications that rely on this component. If you do rebuild MFC30(D).DLL, please rename the DLL.

Steps to fix WINFRM2.CPP Directly

  1. Replace following line of code in CFrameWnd::CanDock():

          if (pDockBar->IsDockBar() &&
    
             (pDockBar->m_dwStyle & dwDockStyle & CBRS_ALIGN_ANY) &&
             (!pDockBar->m_bFloating ||
          (dwDockStyle & pDockBar->m_dwStyle & CBRS_FLOAT_MULTI)))
    
       with this code:
    
          if (pDockBar->IsDockBar() && pDockBar->IsWindowVisible() &&
             (pDockBar->m_dwStyle & dwDockStyle & CBRS_ALIGN_ANY) &&
             (!pDockBar->m_bFloating ||
             (dwDockStyle & pDockBar->m_dwStyle & CBRS_FLOAT_MULTI)))
    
    

  2. Rebuild the MFC library according to the instructions in the ..\MSVC\MFC\SRC\README.TXT file.

STATUS

Microsoft has confirmed this to be a bug in the Microsoft products listed at the beginning of this article. This problem was corrected in Visual C++, 32-bit Edition, version 2.1.


Additional reference words: 2.00 3.0 3.00 CToolbar CDockBar
KBCategory: kbprg kbbuglist kbfixlist
KBSubcategory: MfcUI

Keywords : MfcUI kbbuglist kbfixlist kbprg
Technology : kbMfc
Version : 2.00
Platform : NT WINDOWS
Solution Type : kbfix


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: September 18, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.