AddColumn PowerScript function

Description

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

Controls

ListView controls

Syntax

<span>listviewname.</span><span>AddColumn</span> ( <span>label, alignment, width</span> )

1	<span>listviewname.</span><span>AddColumn</span> ( <span>label, alignment, width</span> )

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.

Return Values

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

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

integer index

1	integer index

FOR index = 3 to 25

1	FOR index = 3 to 25

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

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

NEXT

This.<span>AddColumn</span>("Name" , Left! , 1000)

1	This.<span>AddColumn</span>("Name" , Left! , 1000)

This.<span>AddColumn</span>("Size" , Left! , 400)

1	This.<span>AddColumn</span>("Size" , Left! , 400)

This.<span>AddColumn</span>("Date" , Left! , 300)

1	This.<span>AddColumn</span>("Date" , Left! , 300)

Connection Information

AddColumn – PB Docs 125