---
title: Grid client-side interaction helpers
summary: Emits Infragistics grid client-side scripting to scroll to, begin-edit, or focus a specific grid cell after a postback.
status: draft
owner: SAIF Doc Gen
last_reviewed: 2026-08-17
library: SAIF.Presentation.Web.Core.Infragistics111
reference_type: package
operation_id: OP-CORE-012
trigger: Consuming page needs to place the user in a specific grid cell after a postback
---

# Grid client-side interaction helpers

This operation registers client-side scripts that drive the Infragistics client-side grid API to scroll a row into view, begin editing a cell, or focus a cell, following the flavour-specific API of `UltraWebGrid`, `WebDataGrid`, or `WebHierarchicalDataGrid`.

| Field | Value |
| --- | --- |
| **Operation ID** | OP-CORE-012 |
| **Trigger** | Consuming page needs to place the user in a specific grid cell after a postback |
| **Inputs** | `Page`, grid ID, target row/record, column key |
| **Outputs** | Registered client scripts targeting the Infragistics client-side grid API |
| **Primary components** | `Utilities.clsControlManager.GridScrollToView`, `GridBeginEdit`, `WdgBeginEdit`, `WhdgBeginEdit`, `GridEditFocus`, `MasterGridEditFocus`, `ClearMasterGridEditFocus`, `EnableGridCell` |
| **Entry point** | `SAIF.Presentation.Web.Core.Infragistics111/clsControlManager.vb` |

## Steps

1. Resolve the target row/record and column key from the caller's parameters.
2. Emit the Infragistics client-side call appropriate to the grid flavour: ([BR-CORE-033](../business-rules.md#br-core-033-grid-scrollbegin-editfocus-behavior-is-implemented-per-infragistics-grid-flavour-ultrawebgrid-webdatagrid-webhierarchicaldatagrid))
   - `UltraWebGrid`: scroll-into-view / begin-edit / edit-focus via the UltraWebGrid client object model.
   - `WebDataGrid`: the equivalent `WdgBeginEdit` client script.
   - `WebHierarchicalDataGrid`: the equivalent `WhdgBeginEdit` client script.
3. Register the script with the page so it runs after the postback completes.
4. `ClearMasterGridEditFocus` removes a previously registered master-grid focus request when it is no longer needed.
5. `EnableGridCell` toggles an `UltraGridCell` between editable and read-only independent of the scroll/focus scripts.

## Process flow

The following diagram visualizes this operation's control flow.

```mermaid
flowchart TD
	Start([Post-postback grid focus requested]) --> S1[Resolve target row/record and column key]
	S1 --> S2{Grid flavour?}
	S2 -->|UltraWebGrid| S3[Emit UltraWebGrid client scroll/edit/focus script]
	S2 -->|WebDataGrid| S4[Emit WdgBeginEdit client script]
	S2 -->|WebHierarchicalDataGrid| S5[Emit WhdgBeginEdit client script]
	S3 --> S6[Register script with page]
	S4 --> S6
	S5 --> S6
	S6 --> EndOk([Runs after postback completes])
```

## Failure and edge-case behavior
- No validation is performed on the supplied row/record or column key before script assembly; an invalid reference would fail silently at the client (the Infragistics client API call would no-op or error in the browser console).**

## Related documentation
- [Operations and processes](../operations-processes.md)
- [Business rules](../business-rules.md)

## Sources
- `SAIF.Presentation.Web.Core.Infragistics111/clsControlManager.vb`