id	summary	reporter	owner	description	type	status	milestone	component	version	severity	resolution	keywords	cc
4097	GuiListView Extended Styles Documentation	MattyD		"Hey jpm

The _GUICtrlListView_Create documentation suggests you can use the LV_EX constants as extended window styles, but they're a different thing. The constants can only be used with _GUICtrlListView_SetExtendedListViewStyle as demonstrated below.

{{{#!autoit
#include <GuiListView.au3>
#include <GuiConstants.au3>

Global $hGUI = GUICreate(""Test"", 400, 200)
Global $hLV = _GUICtrlListView_Create($hGUI, ""Col A"", 10, 10, 380, 180)
_GUICtrlListView_SetExtendedListViewStyle($hLV, $LVS_EX_CHECKBOXES)
For $i = 1 To 10
    _GUICtrlListView_AddItem($hLV, ""item "" & $i)
Next

ConsoleWrite(""LV ExStyle: "" & _GUICtrlListView_GetExtendedListViewStyle($hLV) & @CRLF)
ConsoleWrite(""Window ExStyle: "" & _WinAPI_GetWindowLong($hLV, $GWL_EXSTYLE) & @CRLF)

GUISetState()

Do
Until GUIGetMsg() = $GUI_EVENT_CLOSE

GUIDelete()
}}}

Also, in the _GUICtrlListView_SetExtendedListViewStyle documentation we could probably add the following:

{{{
$LVS_EX_AUTOAUTOARRANGE - Automatically arrange icons if no icon positions have been set. (Windows Vista and later)
$LVS_EX_AUTOSIZECOLUMNS - Automatically size listview columns. (Windows Vista and later)
$LVS_EX_COLUMNOVERFLOW - Indicates that an overflow button should be displayed in icon/tile view if necessary.  Requires LVS_EX_HEADERINALLVIEWS to be also specified. 
$LVS_EX_COLUMNSNAPPOINTS - Snap to minimum column width when the user resizes a column. (Windows Vista and later)
$LVS_EX_HEADERINALLVIEWS - Show column headers in all view modes. (Windows Vista and later) 
$LVS_EX_HIDELABELS - Hides the labels in icon and small icon view.
$LVS_EX_JUSTIFYCOLUMNS - Icons are lined up in columns that use up the whole view. (Windows Vista and later)
$LVS_EX_SNAPTOGRID - In icon view, icons automatically snap into a grid.
$LVS_EX_TRANSPARENTBKGND - Background is painted by the parent via WM_PRINTCLIENT. (Windows Vista and later)
$LVS_EX_TRANSPARENTSHADOWTEXT - Enable shadow text on transparent backgrounds only. (Windows Vista and later)
}}}

And maybe remove this one? (Do we still support < v6.0?)
{{{
$LVS_EX_REGIONAL - Sets the control region to include only the item icons and text 
-- Version 4.71 through Version 5.80 only. Not supported on Windows Vista and later. --
}}}

I'd also suggest updating the LVS Extended style table in the appendix, but it seems you can use some of the LV_EX styles with GUICtrlCreateListView.  So adding extra constants into that table could invalidate the GUICtrlCreateListView documentation. I'm guessing there's some internal filtering going on in that func, and there's a risk of LVS_EX values clashing with WS_EX ones!

Cheers,
Matt
​"	Bug	new		Documentation	3.3.18.0	None