LvwColumnHeaders class

The collection of the columns of a ListView, which its ColumnHeaders property returns. Its items are LvwColumnHeader objects, numbered from 1, and a column can have a key as well.

With ListView1
    .View = LvwViewReport
    .ColumnHeaders.Add , "name", "Name"
    .ColumnHeaders.Add , "size", "Size", 1000, LvwColumnHeaderAlignmentRight
    .ColumnHeaders.Add 2, "type", "Type"                ' between the two
    Debug.Print .ColumnHeaders.Count; .ColumnHeaders("size").Index
    Debug.Print .ColumnHeaders(2).Text; .ColumnHeaders("size").Alignment = LvwColumnHeaderAlignmentRight
End With
' Output:
'  3  3
' TypeTrue

A program goes through the columns with For Each, or by number from 1 to Count. It cannot make an LvwColumnHeaders object with New. The number of a column, its Index, is its place in the collection, and stays when the user drags the column to another place; ItemFromPosition finds a column by its place on the screen.

Properties

Count

The number of columns. Long, read-only.

Item

Returns one column. It is the default member, so ListView1.ColumnHeaders("size") is ListView1.ColumnHeaders.Item("size").

Syntax: object.Item( Index ) As LvwColumnHeader

Index
required The number of the column, from 1 to Count, or its key as a String, in which capital and small letters are the same.

A number outside that range raises run-time error 9, and a key that no column has raises run-time error 5. Exists asks without an error.

ItemFromPosition

Returns the column at a place, from the left, as the user sees the columns. An LvwColumnHeader.

Syntax: object.ItemFromPosition( Position ) As LvwColumnHeader

Position
required A Long: the place, from 1.

Methods

Add

Adds a column and returns its LvwColumnHeader.

Syntax: object.Add( [ Index ] [, Key ] [, Text ] [, Width ] [, Alignment ] [, Icon ] ) As LvwColumnHeader

Index
optional A Long: the number the new column gets. The columns from that number on move up by one. Without it, or with 0, the column goes after the last one.
Key
optional A String by which the program can name the column.
Text
optional A String: the text of the column’s header.
Width
optional A Single: the width, in the scale units of the control’s container. Without it the column is one inch wide, 1440 twips.
Alignment
optional A member of LvwColumnHeaderAlignmentConstants: how the column’s texts are aligned. The default is LvwColumnHeaderAlignmentLeft. The first column takes any of them as well.
Icon
optional The number or the key of the header’s icon in the image list of ColumnHeaderIcons.

A negative Index, and one greater than Count + 1, raises run-time error 35600. A Key that another column has raises run-time error 457, and no column is added. A key for an icon that the image list does not have, or a key while there is no image list, raises run-time error 35601. A negative Width, and an Alignment that is not a member, raise run-time error 380.

Adding a column in front of others leaves the subitems of the items where they are, so the later columns then show other texts; see Subitems.

Clear

Removes every column.

Syntax: object.Clear

Exists

Returns whether the collection has a column of a number or a key.

Syntax: object.Exists( Index ) As Boolean

Index
required The number or the key to look for.

Remove

Removes one column. The columns after it move down by one.

Syntax: object.Remove Index

Index
required The number or the key of the column. One that the collection does not have raises the error that Item raises for it.

The subitems of the items stay as they are; see Subitems.

See Also