Partilhar via


Understanding Window Traits

Window traits classes provide a simple method for standardizing the styles used for the creation of an ATL window object. Window traits are accepted as template parameters by CWindowImpl and other ATL window classes as a way of providing default window styles at the class level.

If the creator of a window instance doesn't provide styles explicitly in the call to Create, you can use a traits class to ensure that the window is still created with the correct styles. You can even ensure that certain styles are set for all instances of that window class while permitting other styles to be set on a per-instance basis.

ATL Window Traits Templates

ATL provides two window traits templates that allow you to set default styles at compile time using their template parameters.

Class

Description

CWinTraits

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 Create. The styles provided at run time take precedence over the styles set at compile time.

CWinTraitsOR

Use this class when you want to specify styles that must always be set for the window class. The styles provided at run time are combined with the styles set at compile time using the bitwise OR operator.

In addition to these templates, ATL provides a number of predefined specializations of the CWinTraits template for commonly used combinations of window styles. See the CWinTraits reference documentation for full details.

Custom Window Traits

In the unlikely situation that specializing one of the templates provided by ATL isn't sufficient and you need to create your own traits class, you just need to create a class that implements two static functions: GetWndStyle and GetWndStyleEx:

static DWORD GetWndStyle(DWORD dwStyle);
static DWORD GetWndExStyle(DWORD dwExStyle);

Each of these functions will be passed some style value at run time which it can use to produce a new style value. If your window traits class is being used as the template argument to an ATL window class, the style values passed to these static functions will be whatever was passed as the style arguments to Create.

See Also

Other Resources

ATL Window Classes