Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This macro sets extended styles for a list-view control by using the style mask. You can use this macro or send the LVM_SETEXTENDEDLISTVIEWSTYLEmessage explicitly.

Syntax 

void ListView_SetExtendedListViewStyleEx(
   HWND 
hwndLV,
   DWORD 
dwExMask,
   DWORD 
dwExStyle
);

Parameters

hwndLV

Handle to the list-view control that will receive the style change.

dwExMask

DWORD value that specifies which styles in dwExStyleare to be affected. This parameter can be a combination of extended list-view control styles. Only the extended styles in dwExMaskwill be changed. All other styles will be maintained as they are. If this parameter is zero, all of the styles in dwExStylewill be affected.

dwExStyle

DWORD value that specifies the extended list-view control style. This parameter can be a combination of extended styles.

Return Value

None.

Remarks

When you use this macro to set the LVS_EX_CHECKBOXES style, any previously set state image index will be discarded. All check boxes will be initialized to the cleared state. The state image index is contained in bits 12 through 15 of the state member of the LVITEMstructure.

Requirements

Header commctrl.h
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also