AddColumn

Description

Adds a column with a specified label, alignment, and width.

Applies to

ListView controls

Syntax

listviewname.AddColumn ( label, alignment, width )

Argument

Description

listviewname

The name of the ListView control to which you want to add a column.

label

A string whose value is the name of the column you are adding.

alignment

A value of the enumerated datatype Alignment specifying the alignment of the column you are adding. Values are:

  • Center!

  • Justify!

  • Left!

  • Right!

width

An integer whose value is the width of the column you are adding, in PowerBuilder units.

Returns

Integer. Returns the column index if it succeeds and -1 if an error occurs.

Usage

The AddColumn function adds a column at the end of the existing columns unlike the InsertColumn function which inserts a column at a specified location.

Use SetItem and SetColumn to change the values for existing items. To add new items, use AddItem. To create columns for the report view of a ListView control, use AddColumn.

Examples

Example 1

This script for a ListView event creates three columns in a ListView control:

integer index


FOR index = 3 to 25

    This.AddItem ("Category " + String (index), 1 )

NEXT


This.AddColumn("Name" , Left! , 1000)

This.AddColumn("Size" , Left! , 400)

This.AddColumn("Date" , Left! , 300)

See also