~~Title: DialogListColumns ~~
<pageheader/>

The **DialogListColumns** object lets you query or modify the columns in a //Details// mode //list view// control in a [[:scripting:script_dialogs|script dialog.]] Use the **[[control|Control]].columns** property to obtain a **DialogListColumns** object.



You can enumerate this object to query the current columns. Each column is represented by a **[[dialoglistcolumn|DialogListColumn]]** object.  


<commandtable columns="4" id="cmdtable_1">
$$ Method Name
$$ **Arguments**
$$ Return Type
$$ Description
$$ AddColumn
$$ <string:name>\\
$$ //int//
$$ Adds a new column to the list view, and returns the index of the new column.
$$ AutoSize
$$ //none//\\
$$ //none//
$$ Automatically sizes all columns in the list view to fit their content.
$$ DeleteColumn
$$ <int:index>
$$ //none//
$$ Deletes the specified column.
$$ GetColumnAt
$$ <int:index>
$$ //object://\\
**[[dialoglistcolumn|DialogListColumn]]**
$$ Returns a **[[dialoglistcolumn|DialogListColumn]]** object representing the column in the specified position.
$$ GetDisplayOrder
$$ //none//
$$ object:**[[vector|Vector]]** 
$$ Returns the order which the list's columns are displayed on the screen. This may differ from their natural order if you have previously changed it via **SetDisplayOrder**.\\
The vector contains the index of each column in the order it appears. As an example, if you create a list with three columns (indexes 0, 1, 2) and move the last one (2) to the start, the returned vector will contain three integers: 2,0,1.
$$ InsertColumn
$$ <string:name>\\
<int:position>
$$ //int//
$$ Inserts a new column in the list view at the specified position, and returns the index of the new column.
$$ SetDisplayOrder
$$ <int:indexA>\\
<int:indexB>\\
<int:indexC>\\
...\\
or\\
<**[[vector|Vector]]**:indexes>
$$ //none//
$$ Changes the order in which the list's columns are displayed.\\
This can be particularly useful when you want to place one or more columns before the main one, which is not possible when initially creating the columns (due to the way Windows list controls behave). The main column is special, in that it is the only one which can have a checkbox or editable label, but you may not always want it to be displayed first.\\
You can either pass the column indexes directly as arguments, or pass a vector (or most other collection types) of integers with the same thing.\\
As an example, if you create a list with three columns (indexes 0, 1, 2) and want to move the last column (2) to the start: //SetDisplayOrder(2,0,1)//\\
This only changes the order the columns are displayed on the screen; the column indexes you use in your code do not change afterwards.
</commandtable>