DOC: CWnd::LockWindowUpdate Does Not Unlock the Window

• Microsoft Visual C++, 32-bit Editions, versions 1.0, 2.0, 2.1, 2.2, 4.0
• Microsoft Foundation Classes (MFC)
• Microsoft Visual C++ for Windows, versions 1.0, 1.5, 1.51, 1.52

SUMMARY

The documentation for CWnd::LockWindowUpdate() states this function will disable or reenable drawing for the CWnd object. In the remarks section, the sentence "Disables or reenables drawing in the given window" is incorrect. Starting with Visual C++ version 2.0, you should use CWnd::UnlockWindowUpdate() to reenable drawing to a window locked with CWnd::LockWindowUpdate().

The documentation error was corrected in Visual C++ 4.1.

MORE INFORMATION

CWnd::LockWindowUpdate() takes no parameters and is implemented as an in-line call to the Windows function ::LockWindowUpdate(). The function ::LockWindowUpdate() is called with the this->m_hWnd parameter which causes the window to be locked. To re-enable drawing, NULL should be passed to ::LockWindowUpdate().

In Visual C++ version 2.0 and later, call CWnd::UnlockWindowUpdate() to reenable drawing to your window. In earlier versions, call the Windows ::LockWindowUpdate( NULL ).

Additional query words: 1.00 1.50 2.00 2.10 2.20 dskbsweep 4.00 4.10

Keywords : kbdocfix kbMFC KbUIDesign kbVC
Version : winnt:1.0,2.0,2.1,2.2,4.0; :1.0,1.5,1.51,1.52
Platform : winnt
Issue type :