Share via


CWinTraits 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 CWinTraits Class.

This class provides a method for standardizing the styles used when creating a window object.

Important

This class and its members cannot be used in applications that execute in the Windows Runtime.

Syntax

template <DWORD t_dwStyle = 0, DWORD t_dwExStyle = 0>  class CWinTraits

Parameters

t_dwStyle
Default standard window styles.

t_dwExStyle
Default extended window styles.

Members

Public Methods

Name Description
CWinTraits::GetWndExStyle (Static) Retrieves the extended styles for the CWinTraits object.
CWinTraits::GetWndStyle (Static) Retrieves the standard styles for the CWinTraits object.

Remarks

This window traits class provides a simple method for standardizing the styles used for the creation of an ATL window object. Use a specialization of this class as a template parameter to CWindowImpl or another of ATL's window classes to specify the default standard and extended styles used for instances of that window class.

Use this template when you want to provide default window styles that will be used only when no other styles are specified in the call to CWindowImpl::Create.

ATL provides three predefined specializations of this template for commonly used combinations of window styles:

CControlWinTraits
Designed for a standard control window. The following standard styles are used: WS_CHILD, WS_VISIBLE, WS_CLIPCHILDREN, and WS_CLIPSIBLINGS. There are no extended styles.

CFrameWinTraits
Designed for a standard frame window. The standard styles used include: WS_OVERLAPPEDWINDOW, WS_CLIPCHILDREN, and WS_CLIPSIBLINGS. The extended styles used include: WS_EX_APPWINDOW and WS_EX_WINDOWEDGE.

CMDIChildWinTraits
Designed for a standard MDI child window. The standard styles used include: WS_OVERLAPPEDWINDOW, WS_CHILD, WS_VISIBLE, WS_CLIPCHILDREN, and WS_CLIPSIBLINGS. The extended styles used include: WS_EX_MDICHILD.

If you want to ensure that certain styles are set for all instances of the window class while permitting other styles to be set on a per-instance basis, use CWinTraitsOR instead.

Requirements

Header: atlwin.h

CWinTraits::GetWndStyle

Call this function to retrieve the standard styles of the CWinTraits object.

static DWORD GetWndStyle(DWORD dwStyle);

Parameters

dwStyle
Standard styles used for creation of a window. If dwStyle is 0, the template style values ( t_dwStyle) are returned. If dwStyle is nonzero, dwStyle is returned.

Return Value

The standard window styles of the object.

CWinTraits::GetWndExStyle

Call this function to retrieve the extended styles of the CWinTraits object.

static DWORD GetWndExStyle(DWORD dwExStyle);

Parameters

dwExStyle
Extended styles used for creation of a window. If dwExStyle is 0, the template style values ( t_dwExStyle) are returned. If dwExStyle is nonzero, dwExStyle is returned.

Return Value

The extended window styles of the object.

See Also

Class Members
Class Overview
Understanding Window Traits