ListView_SetExtendedListViewStyleEx macro

Sets extended styles for list-view controls using the style mask. You can use this macro or send the LVM_SETEXTENDEDLISTVIEWSTYLE message explicitly.

Syntax


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

Parameters

hwndLV

Type: HWND

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

dwExMask

Type: DWORD

A DWORD value that specifies which styles in dwExStyle are to be affected. This parameter can be a combination of Extended List-View Styles. Only the extended styles in dwExMask will be changed. All other styles will be maintained as they are. If this parameter is zero, all of the styles in dwExStyle will be affected.

dwExStyle

Type: DWORD

A DWORD value that specifies the extended list-view control styles to set. This parameter can be a combination of Extended List-View Styles. Styles that are not set, but that are specified in dwExMask, are removed.

Return value

No return value.

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 unchecked state. The state image index is contained in bits 12 through 15 of the state member of the LVITEM structure.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Commctrl.h

 

 

Show: