DOCUMENT:Q165746  30-JUL-2001  [visualc]
TITLE   :DOC: Incomplete Documentation on CListCtrl::SetColumnWidth
PRODUCT :Microsoft C Compiler
PROD/VER:winnt:5.0
OPER/SYS:
KEYWORDS:kbui kbdocfix kbdocerr kbListView kbMFC KbUIDesign kbVC500bug kbVC600fix kbGrpDSMFCATL

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

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

 - The Microsoft Foundation Classes (MFC), used with:
    - Microsoft Visual C++, 32-bit Enterprise Edition, version 5.0 
    - Microsoft Visual C++, 32-bit Professional Edition, version 5.0 
-------------------------------------------------------------------------------

SUMMARY
=======

The online documentation for CListCtrl::SetColumnWidth is incomplete. The
current documentation says:

CListCtrl::SetColumnWidth
-------------------------

   BOOL SetColumnWidth( int nCol, int cx );

    Return Value
       Nonzero if successful; otherwise zero.

Parameters
   nCol   Index of the column whose width is to be set. In list view,
          this parameter must be [ASCII 150]1.

   cx   The new width of the column.

Remarks
   Changes the width of a column in report view or list view.

The documentation of the parameter cx is incomplete and should be the
following:

  cx   New width of the column, in list view coordinates, or one of the
       following values:

  Value                      Meaning
  -----                      -------
  LVSCW_AUTOSIZE             Automatically sizes the column.
  LVSCW_AUTOSIZE_USEHEADER   Automatically sizes the column to fit the
                             header text.

This documentation was corrected in Visual C++ version 6.0 for Windows.

Additional query words: MFC listview

======================================================================
Keywords          : kbui kbdocfix kbdocerr kbListView kbMFC KbUIDesign kbVC500bug kbVC600fix kbGrpDSMFCATL 
Technology        : kbAudDeveloper kbMFC
Version           : winnt:5.0

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

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.

Copyright Microsoft Corporation 2001.