CWinTraitsOR Class

 

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

For the latest documentation on Visual Studio 2017, see CWinTraitsOR Class on docs.microsoft.com. 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: