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"