GetItem

Description

Gets the value of an item for the specified row and column. GetItem returns the value available in the data available to the client. This is equivalent to the primary buffer in other environments.

Applies to

Web DataWindow client control

Syntax

returnvalue objdwcontrol.GetItem (number row, number column )
returnvalue objdwcontrol.GetItem (number row, string column )

Argument

Description

objdwcontrol

A reference to a Web DataWindow client 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 the empty string ("") if an error occurs.

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 dwEmployee:

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

See also