CCtrlView Class
The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.
The latest version of this topic can be found at CCtrlView Class.
Adapts the document-view architecture to the common controls supported by Windows 98 and Windows NT versions 3.51 and later.
Syntax
class CCtrlView : public CView
Members
Public Constructors
| Name | Description |
|---|---|
| CCtrlView::CCtrlView | Constructs a CCtrlView object. |
Protected Methods
| Name | Description |
|---|---|
| CCtrlView::OnDraw | Called by the framework to draw using the specified device context. |
| CCtrlView::PreCreateWindow | Called before the creation of the Windows window attached to this CCtrlView object. |
Protected Data Members
| Name | Description |
|---|---|
| CCtrlView::m_dwDefaultStyle | Contains the default style for the view class. |
| CCtrlView::m_strClass | Contains the Windows class name for the view class. |
Remarks
The class CCtrlView and its derivatives, CEditView, CListView, CTreeView, and CRichEditView, adapt the document-view architecture to the new common controls supported by Windows 95/98 and Windows NT versions 3.51 and later. For more information on the document-view architecture, see Document/View Architecture.
Inheritance Hierarchy
CCtrlView
Requirements
Header: afxwin.h
CCtrlView::CCtrlView
Constructs a CCtrlView object.
CCtrlView(
LPCTSTR lpszClass,
DWORD dwStyle);
Parameters
lpszClass
Windows class name of the view class.
dwStyle
Style of the view class.
Remarks
The framework calls the constructor when a new frame window is created or a window is split. Override CView::OnInitialUpdate to initialize the view after the document is attached. Call CWnd::Create or CWnd::CreateEx to create the Windows object.
CCtrlView::m_strClass
Contains the Windows class name for the view class.
CString m_strClass;
CCtrlView::m_dwDefaultStyle
Contains the default style for the view class.
DWORD m_dwDefaultStyle;
Remarks
This style is applied when a window is created.
CCtrlView::OnDraw
Called by the framework to draw the contents of the CCtrlView object using the specified device context.
virtual void OnDraw(CDC* pDC);
Parameters
pDC
A pointer to the device context in which the drawing occurs.
Remarks
OnDraw is typically called for screen display, passing a screen device context specified by pDC.
CCtrlView::PreCreateWindow
Called before the creation of the Windows window attached to this CWnd object.
virtual BOOL PreCreateWindow(CREATESTRUCT& cs);
Parameters
cs
A CREATESTRUCT structure.
Return Value
Nonzero if the window creation should continue; 0 to indicate creation failure.
Remarks
Never call this function directly.
The default implementation of this function checks for a NULL window class name and substitutes an appropriate default. Override this member function to modify the CREATESTRUCT structure before the window is created.
Each class derived from CCtrlView adds its own functionality to its override of PreCreateWindow. By design, these derivations of PreCreateWindow are not documented. To determine the styles appropriate to each class and the interdependencies between the styles, you can examine the MFC source code for your application's base class. If you choose to override PreCreateWindow, you can determine whether the styles used in your application's base class provide the functionality you need by using information gathered from the MFC source code.
For more information on changing window styles, see the Changing the Styles of a Window Created by MFC.
See Also
CView Class
Hierarchy Chart
CTreeView Class
CListView Class
CRichEditView Class