Columns

Returns or sets a value that determines whether a ListBox control scrolls vertically or horizontally and how the items in the columns are displayed. If it scrolls horizontally, the Columns property determines how many columns are displayed.

Syntax

object.Columns [= number]

The parts of the Columns property syntax are described in the following table.

Part Description
object An object expression that evaluates to an object.
number An integer that specifies how a control scrolls and how items are arranged in columns, as described in Settings.

Settings

The settings for number are described in the following table.

Setting Description
0 (Default) Items are arranged in a single column and the ListBox scrolls vertically.
1 to n Items are arranged in snaking columns, filling the first column, then the second column, and so on. The ListBox scrolls horizontally and displays the specified number of columns.

Remarks

For horizontal-scrolling ListBox controls, the column width is equal to the width of the ListBox divided by the number of columns.

This property can not be set to 0 or changed from 0 at run time — that is, you cannot change a multiple-column ListBox to a single-column ListBox or a single-column ListBox to a multiple-column ListBox at run time. However, you can change the number of columns in a multiple-column ListBox at run time.