###Function###
GUICtrlCreateListView

###Description###
Creates a ListView control for the GUI.

###Syntax###
GUICtrlCreateListView ( "text", left, top [, width [, height [, style = -1 [, exStyle = -1]]]] )


###Parameters###
@@ParamTable@@
text
	definition of columns heading. Each of them are separated with <a href="AutoItSetOption.htm#GUIDataSeparatorChar">Opt("GUIDataSeparatorChar")</a>.
left
	The left side of the control. If -1 is used then left will be computed according to <a href="AutoItSetOption.htm#GUICoordMode">GUICoordMode</a>.
top
	The top of the control. If -1 is used then top will be computed according to <a href="AutoItSetOption.htm#GUICoordMode">GUICoordMode</a>.
width
	[optional] The width of the control (default is the previously used width).
height
	[optional] The height of the control (default is the previously used height).
style
	[optional] Defines the style of the control. See <a href="../appendix/GUIStyles.htm#ListView">GUI Control Styles Appendix</a>.
		default (-1) : $LVS_SHOWSELALWAYS, $LVS_SINGLESEL
		forced style : $LVS_REPORT
exStyle
	[optional] Defines the extended style of the control. See <a href="../appendix/GUIStyles.htm#Extended">Extended Style Table</a> or <a href="../appendix/GUIStyles.htm#ListViewExtended">ListView Extended Style Table</a>.
		default (-1) : $LVS_EX_FULLROWSELECT, $WS_EX_CLIENTEDGE
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	the identifier (controlID) of the new control.
Failure:	0.
@@End@@


###Remarks###
To add items to a ListView control use <a href="GUICtrlCreateListViewItem.htm">GUICtrlCreateListViewItem()</a>

The ListView will appear by default as in the Explorer view "Details" (LVS_REPORT style is forced).
You can control initial column size by padding blanks to the column heading definition. The column can be extend during the <a href="GUICtrlCreateListViewItem.htm">GUICtrlCreateListViewItem()</a> according to item size. Size of a column will be up to around 25 characters. No resizing will be done during an update by <a href="GUICtrlSetData.htm">GUICtrlSetData()</a>.

To create a ListView with Icon-, SmallIcon- or List-style just use after creation:
<a href="GUICtrlSetStyle.htm">GUICtrlSetStyle()</a> with the styles $LVS_ICON, $LVS_LIST or $LVS_SMALLICON.

Sorting the list by clicking the column name (as in Explorer) is not currently implemented.

To have the entire line visually selected use the <a href="../appendix/GUIStyles.htm#Extended">extended style</a> LVS_EX_FULLROWSELECT.

To combine styles with the default style use <a href="BitOR.htm">BitOR</a>($GUI_SS_DEFAULT_LISTVIEW, newstyle, ... ).
To use the values specified above you must #include <ListViewConstants.au3> in your script.

If you add the style $LVS_EX_CHECKBOXES to the ListView, then the borders are removed. Add the style $WS_EX_CLIENTEDGE to display the borders.


The special flag $GUI_BKCOLOR_LV_ALTERNATE can be used with Listview control to give alternate background of the ListviewItems lines.
The odd lines will get the color set by <a href="GUICtrlSetBkColor.htm">GUICtrlSetBkColor()</a> of the Listview control.
The even lines will get the color set by <a href="GUICtrlSetBkColor.htm">GUICtrlSetBkColor()</a> of the ListviewItem control.


###Related###
GUICoordMode (Option), GUICtrlCreateListViewItem, GUICtrlRegisterListViewSort, GUICtrlSetData, GUIDataSeparatorChar (Option), GUIGetMsg


###Example###
@@IncludeExample@@
