ListView_SetExtendedListViewStyle macro (commctrl.h)

Article
10/21/2024

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

Syntax

void ListView_SetExtendedListViewStyle(
   HWND  hwndLV,
   DWORD dw
);

Parameters

hwndLV

Type: HWND

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

dw

Type: DWORD

A DWORD value that specifies the extended list-view control style. This parameter can be a combination of Extended List-View Styles.

Return value

None

Remarks

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

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

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

Share via