CWinTraitsOR Class

 

For the latest documentation on Visual Studio 2017 RC, see Visual Studio 2017 RC Documentation.

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

System_CAPS_ICON_important.jpg Important

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

template <DWORD t_dwStyle = 0,
          DWORD t_dwExStyle = 0, 
          class TWinTraits = CControlWinTraits>
class CWinTraitsOR

Parameters

t_dwStyle
Default window styles.

t_dwExStyle
Default extended window styles.

Public Methods

NameDescription
CWinTraitsOR::GetWndExStyleRetrieves the extended styles for the CWinTraitsOR object.
CWinTraitsOR::GetWndStyleRetrieves the standard styles for the CWinTraitsOR object.

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 minimum set of standard and extended styles to be used for instances of that window class.

Use a specialization of this template 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 in the call to CWindowImpl::Create.

If you want to provide default window styles that will be used only when no other styles are specified in the call to CWindowImpl::Create, use CWinTraits instead.

Header: atlwin.h

Call this function to retrieve a combination (using the logical OR operator) of the standard styles of the CWinTraits object and the default styles specified by t_dwStyle.

static DWORD GetWndStyle(DWORD dwStyle);

Parameters

dwStyle
Styles used for creation of a window.

Return Value

A combination of styles that are passed in dwStyle and the default ones specified by t_dwStyle, using the logical OR operator.

Call this function to retrieve a combination (using the logical OR operator) of the extended styles of the CWinTraits object and the default styles specified by t_dwStyle.

static DWORD GetWndExStyle(DWORD dwExStyle);

Parameters

dwExStyle
Extended styles used for creation of a window.

Return Value

A combination of extended styles that are passed in dwExStyle and default ones specified by t_dwExStyle, using the logical OR operator

Class Overview
Understanding Window Traits

Show: