ListView_SetExtendedListViewStyleEx macro (commctrl.h)

Article
10/23/2024

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 dwMask,
   DWORD dw
);

Parameters

hwndLV

Type: HWND

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

dwMask

Type: DWORD

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

dw

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

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 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