GetRowIdFromRow

Description

Gets the unique row identifier of a row in a DataWindow control or DataStore object from the row number associated with that row.

Applies to

DataWindow type

Method applies to

PowerBuilder

DataWindow control, DataWindowChild object, DataStore object

Web ActiveX

DataWindow control, DataWindowChild object

Syntax

PowerBuilder

long dwcontrol.GetRowIdFromRow (long rownumber {, DWBuffer buffer } )

Web ActiveX

number dwcontrol.GetRowIdFromRow (number rownumber, number buffer )

Argument

Description

dwcontrol

A reference to a DataWindow control, DataStore, or the child DataWindow.

rownumber

A number specifying the row number for which you want the associated row identifier.

buffer (optional)

A value of the dwBuffer enumerated datatype (PowerBuilder) or an integer (Web ActiveX) identifying the DataWindow buffer that contains the row. For a list of valid values, see DWBuffer.

Returns

Returns the row identifier in buffer. Returns 0 if the row identifier is not in the current buffer and –1 if an error occurs.

If any argument value is null, in PowerBuilder and JavaScript the method returns null.

Usage

The row identifier value is not the same as the row number value used in many DataWindow and DataStore function calls and should not be used for the row number value. Instead you should first convert the unique row identifier into a row number by calling GetRowFromRowId.

NoteRow identifiers The row identifier is relative to the DataWindow that currently owns the row.

Examples

Example 1

This example retrieves the current row’s unique identifier:

long ll_rowid

ll_rowid = dw_emp.GetRowIDFromRow(dw_emp.GetRow())

See also