Table of contents
Collapse the table of content
Expand the table of content

ColumnWidths Property

office 365 dev account|Last Updated: 6/12/2017
1 Contributor

Specifies the width of each column in a multicolumn combo box or list box. Syntaxobject. ColumnWidths [= String ] The ColumnWidths property syntax has these parts:

objectRequired. A valid object.
StringOptional. Sets the column width in points. A setting of -1 or blank results in a calculated width. A width of 0 hides a column. To specify a different unit of measurement, include the unit of measure. A value greater than 0 explicitly specifies the width of the column.

Settings To separate column entries, use semicolons (;) as list separators. In Windows, use the list separator specified in the Regional Settings section of the Windows Control Panel to change this value. Any or all of the ColumnWidths property settings can be blank. You create a blank setting by typing a list separator without a preceding value. If you specify a -1 in the property page, the displayed value in the property page is a blank. To calculate column widths when ColumnWidths is blank or -1, the width of the control is divided equally among all columns of the list. If the sum of the specified column widths exceeds the width of the control, the list is left-aligned within the control and one or more of the rightmost columns are not displayed. Users can scroll the list using the horizontal scroll bar to display the rightmost columns. The minimum calculated column width is 72 points (1 inch). To produce columns narrower than this, you must specify the width explicitly. Unless specified otherwise, column widths are measured in points. To specify another unit of measure, include the units as part of the values. The following examples specify column widths in several units of measure and describe how the various settings would fit in a three-column list box that is 4 inches wide.

90;72;90The first column is 90 points (1.25 inch); the second column is 72 points (1 inch); the third column is 90 points.
6 cm;0;6 cmThe first column is 6 centimeters; the second column is hidden; the third column is 6 centimeters. Because part of the third column is visible, a horizontal scroll bar appears.
1.5 in;0;2.5 inThe first column is 1.5 inches, the second column is hidden, and the third column is 2.5 inches.
2 in;;2 inThe first column is 2 inches, the second column is 1 inch (default), and the third column is 2 inches. Because only half of the third column is visible, a horizontal scroll bar appears.
(Blank)All three columns are the same width (1.33 inches).

Remarks In a combo box, the system displays the column designated by the TextColumn property in the text box portion of the control.

© 2018 Microsoft