Namespace: Consultingwerk.CommonUi
Class 
RowKeyHelper Copy to Clipboard
Parent classes:
Progress.Lang.Object
Consultingwerk.CommonUi.RowKeyHelper

Inherits: Progress.Lang.Object


Navigate to: Methods | Constructors | Events | Properties | ProDatasets | Temp-Tables



Top Method Summary
Options Name Purpose
LOGICAL FindActiveRow (handle, IEventHandlerParameter) Positions the buffer on the active row of the screen values dataset of a server-side event
LOGICAL FindRowByKey (handle, JsonObject) Positions the buffer on the record identified by a row key
Progress.Json.ObjectModel.JsonObject GetRowKey (handle) Returns the row key of the current record of a buffer

Top Constructor Summary
Options Name Purpose
RowKeyHelper () Disallow instance creation


Method Detail
Top

LOGICAL FindActiveRow (handle, IEventHandlerParameter)
Purpose: Positions the buffer on the active row of the screen values
dataset of a server-side event
Notes: Use this instead of find-first in handlers that work on the
active row only - with several selected rows the dataset
carries one row per selected grid row. Positions on the row
identified by the ActiveRowKey of the parameter; without an
ActiveRowKey (events without a grid row context, tables
without a primary unique index) on the first row. Pass the
buffer of the EntityTable, the key is built from it.

Parameters:
phBuffer HANDLE
The buffer of the EntityTable of the screen values dataset
poParameter Consultingwerk.CommonUi.IEventHandlerParameter
The parameter of the server-side event handler
Returns LOGICAL
Logical value indicating if the buffer is positioned on the active row
Top

LOGICAL FindRowByKey (handle, JsonObject)
Purpose: Positions the buffer on the record identified by a row key
Notes: The key properties are converted to the data types of the
key fields, so a key received from a web frontend (dates as
ISO strings, numbers as JSON numbers) resolves as well. Returns
FALSE (and leaves the buffer unavailable) when the table has
no primary unique index, a key property is missing or
malformed, or no record matches

Parameters:
phBuffer HANDLE
The buffer to position
poRowKey Progress.Json.ObjectModel.JsonObject
The row key (JSON object with the values of the primary unique key fields)
Returns LOGICAL
Logical value indicating if a record with the key is available
Top

Progress.Json.ObjectModel.JsonObject GetRowKey (handle)
Purpose: Returns the row key of the current record of a buffer
Notes: A JSON object with one property per field of the primary
unique index (named by the serialize-name of the field).
Returns ? when no record is available or the table has no
primary unique index

Parameters:
phBuffer HANDLE
The buffer positioned on the record
Returns Progress.Json.ObjectModel.JsonObject
The JsonObject with the key values or ?


Constructor Detail
Top

RowKeyHelper ()
Purpose: Disallow instance creation
Notes:



©2006-2026 Consultingwerk Ltd.         info@consultingwerk.de         http://www.consultingwerk.de       09.11.2026 08:04:17