• OnGridInitialize Event
• OnGridExecute Event
• CanSearch Event
• BeforeSearchSave Event
• BeforeSearchLoad Event
• OnSearchPartFilterCompute Event
• OnTitlesRender Event
• OnBeforeExistingRowsRender Event
• OnExistingRowRender Event
• OnAfterExistingRowsRender Event
• OnInitialValueCalculate Event
• OnGridPartRender Event
• OnGroupHeaderRender Event
• OnGroupFooterRender Event
• OnAfterNewRowsRender Event
• OnSummarySectionRender Event
• BeforeSummarySectionRender Event
• ShowRowExpanderIcon Event
• onDetailViewRender Event
• BeforeValidateExistingRecords Event
• BeforeValidateNewRecords Event
• CanUpdateRecord Event
• CanInsertRecord Event
• CanDeleteRecord Event
• AfterUpdateRecords Event
• AfterUpdateRecord Event
• AfterInsertRecord Event
• AfterDeleteRecord Event
• OnExpandRow Event
• OnPageRedirect Event
• OnWriteConflict Event
• onSQLExecuteError Event
• onBeforeSQLCommandExecute and onAfterSQLCommandExecute Events
• onSQLCountQuery Event
• onSQLSelectQuery Event
• onSQLSummaryValuesQuery Event
• onSQLRefreshRowQuery Event

OnInitialValueCalculate Event

Description

This event fires before the New Record rows are displayed.

Discussion

This event can be used to compute the initial values for fields in the Grid.

The following variables are available to you in the event:

Variable

Description

e.tmpl

The grid component definition

e.rtc

Run-time calculations (allows you to pass data to other event handlers)

e.newValues

A 'dot' variable with initial values for each field.

Setting Field Defaults

Suppose you have a Grid component with the following fields: CustomerId, FirstName, LastName, and Company. The default value for new records for these fields can be calculated in the OnInitialValueCalculate server-side event.

For example, suppose you would like to set the default value for Company to an initial value of 'Alpha Software'. This can be done as follows:

e.newValues.CustomerId = ""
e.newValues.FirstName = ""
e.newValues.LastName = ""
e.newValues.Company = "Alpha Software"

Your event can set any of these properties. If you want to change the default value for the Company field and set a default value for the LastName field, then your event would do this:

e.newValues.Company = "My Company Name"
e.newValues.LastName = "Smith"

Setting State Variables

You can also set state variables in this event. The value of any state variables will be available in all subsequent ajax callbacks (in the e.__si2 object).

To set a state variable:

e._state.myvar1 = "value1"
e._state.myvar2 = "value2"