Edit

LVM_SETEXTENDEDLISTVIEWSTYLE message

  • Article

Sets extended styles in list-view controls. You can send this message explicitly or use the ListView_SetExtendedListViewStyle or ListView_SetExtendedListViewStyleEx macro.

Parameters

wParam

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

lParam

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 wParam, are removed.

Return value

Returns a DWORD value that contains the previous extended list-view control styles.

Remarks

The wParam parameter allows you to modify one or more extended styles without having to retrieve the existing styles first. For example, if you pass LVS_EX_FULLROWSELECT for wParam and 0 for lParam, the LVS_EX_FULLROWSELECT style will be cleared but all other styles will remain the same.

For backward compatibility reasons, the ListView_SetExtendedListViewStyle macro has not been updated to use wParam. To use the wParam value, use the ListView_SetExtendedListViewStyleEx macro.

When you use this message 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

Requirement Value
Minimum supported client
 Windows Vista [desktop apps only]
Minimum supported server
 Windows Server 2003 [desktop apps only]
Header
Commctrl.h