GetItem

Description

Gets the value of an item for the specified row and column in a Web DataWindow client control. Use one of the datatype-specific methods such as GetItemString for other types of DataWindow control. GetItem returns the value available in the data available to the client. This is equivalent to the primary buffer in other environments.

Applies to

DataWindow type

Method applies to

Web

Client control

Syntax

Web DataWindow client control

returnvalue dwcontrol.GetItem (number row, number column )

returnvalue dwcontrol.GetItem (number row, string column )

Argument

Description

dwcontrol

A reference to a DataWindow control.

row

A value identifying the row location of the data.

column

The column location of the data. Column can be a column number or a column name. The column number is the number of the column as it is listed in the Column Specification view of the DataWindow painter—not necessarily the number of the column in the Design view.

To get the contents of a computed field, specify the name of the computed field for column. Computed fields do not have numbers.

Returns

Returns the value in the specified row and column. The datatype of the returned data corresponds to the datatype of the column. Returns null if the column value is null. Returns the empty string (“”) if an error occurs.

If any argument value is null, the method returns null.

Usage

Use GetItem to get data that has been accepted by the DataWindow. In a script for the ItemChanged or ItemError event, you can use the newValue argument to find out what the user entered before the data is accepted.

Examples

Example 1

This statement sets LName to the value for row 3 of the emp_name column in the DataWindow dw_employee:

var LName = dw_employee.GetItem(3, "emp_name");

See also