Avoid SetClassLong If Subclassing a Standard Control Class

Last reviewed: July 22, 1997
Article ID: Q68584
3.00 3.10 WINDOWS kbprg

The information in this article applies to:

  • Microsoft Windows Software Development Kit (SDK), versions 3.0 and 3.1

An application should not attempt to create a window subclass for standard Windows controls such as combo boxes and buttons.

SetClassLong() should not be used to subclass an entire standard control class. This would cause all controls of that type (including controls in other applications) created while the subclass was in effect to be subclassed.

SetWindowLong() can be used to subclass individual controls in your application.

In addition, standard Windows controls should only be subclassed in "non- intrusive" ways. Subclassing procedures that alter the appearance of a control or that depend on undocumented messages or message parameters could be incompatible with future versions of Windows.

For more information on subclassing a control, please see the "Safe Subclassing" article on the Microsoft Developer Network (MSDN) CD.

Charles Petzold's "Programming Windows" (Microsoft Press) contains a sample program that shows how to subclass a standard control (in this case, a scroll bar). In the Windows 2.x version of the book, the sample is called COLORSCR; in the Windows 3.0 version, the sample is called COLORS1.


Additional reference words: 3.00 3.10
KBCategory: kbprg
KBSubcategory: UsrCtl
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 22, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.