TIWCGJQGridNavEditFormOptions Class

The caption of add form

Note
Set the text to override the text from language file.

Controls where the row just added is placed: 'first' at the top of the gird, 'last' at the bottom. Where the new row is to appear in its natural sort order, set reloadAfterSubmit: true

This option allow to set global ajax settings for the form editiing when we save the data to the server. Note that with this option is possible to overwrite all current ajax setting in the save request including the complete event.

The caption of cancel button

Note
Set the text to override the text from language file.

The caption of close button

Note
Set the text to override the text from language file.

The caption of exit button

Note
Set the text to override the text from language file.

The caption of NO button

Note
Set the text to override the text from language file.

When set this information is placed just after the buttons of the form as additional row

The caption of submit button

Note
Set the text to override the text from language file.

The caption of Yes button

Note
Set the text to override the text from language file.

This option work only in editing mode. If Set to true this option will work only when a submit button is clicked and if any data is changed in the form. If the data is changed a dilog message appear where the user is asked to confirm the changes or cancel it. Pressing cancel button of the new dialog will return to the form, but does not set the values to its original state.

This option is applicable in add and edit mode. When this option is set to true the behaviour as follow: when something is changed in the form and the user click on Cancel button, navigator buttons, close button (on upper right corner of the form), in overlay (if available) or press Esc key (if set) a message box appear asking the user to save the changes, not to save the changes or go back in the grid cancel all changes (this will close the modal form)

when add mode, clear the data after adding data

when add mode, close the dialog after add record

when in edit mode, close the dialog after editing

Determines the icon of the cancel button. The default values are [true,”left”,”ui-icon-close”]. For description of these see saveicon

Represents property DataWidth.

The caption of edit form

an array used to add content to the data posted to the server

The messages validations

Note
Set the text to override the text from language file.

Defines the type of request to make (“POST” or “GET”) when data is sent to the server

This option works only in edit mode and add keyboard navigation, which allow us to navigate through the records while in form editing pressing certain keys. The default state is disabled. The first item enables/disables the navigation. The second item corresponds to reccord up and by default is the the key code for Up key. The third item corresponds to reccord down and by default is the key code for Down key

This event can be used only when we are in edit mode and the navigator buttons are enabled; it fires after the data for the new row is loaded from the grid, allowing modification of the data or form before the form is redisplayed. afterclickPgButtons : function(whichbutton, formid, rowid) where whichbutton is either 'prev' or 'next' formid is the jQuery object of form id, you can use formid[0].id to get form id. rowid is the id of the current row

This event fires immediately after all actions and events are completed and the row is inserted or updated in the grid. afterComplete : function (response, postdata, formid) {…} where response is the data returned from the server (if any) postdata an array, is the data sent to the server formid is the jQuery object of form id, you can use formid[0].id to get form id.

fires after showing the form; receives as Parameter the id of the constructed form. afterShowForm : function (formid) {…}

fires after response has been received from server. Typically used to display status from server (e.g., the data is successfully saved or the save cancelled for server-side editing reasons). Receives as parameters the data returned from the request and an array of the posted values of type id=value1,value2. When used this event should return array with the following items [success, message, new_id] where success is a boolean value if true the process continues, if false a error message appear and all other processing is stopped. (message is ignored if success is true). new_id can be used to set the new row id in the grid when we are in add mode. afterSubmit : function(response, postdata) { … return [success,message,new_id] }

This event fires before checking the values (if checking is defined in colModel via editrules option). To this event we pass the following parameters: 1. posdata - the array of values which should be chaced in name:value pair, where the name is the name from colModel. 2. formid - the form id object. 3. mode - the current mode in which we are - can be add or edit. In all cases the event should return object in name value pair which then will be posted to the server.

fires before initialize the new form data. Receives, as parameter, the id of the constructed form. beforeInitData : function(formid) {…}

fires before showing the form with the new data; receives as Parameter the id of the constructed form. beforeShowForm : function(formid) {…}

fires before the data is submitted to the server. Recieves as parameter the posted data array and the formid. beforeSubmit : function(postdata, formid) { … return[success,message]; } When defined this event should return array with the following values success boolean indicating if the proccess should continue (true) or a error (false) message should appear to the user

fires after the submit button is clicked and the postdata is constructed. Parameters passed to this event are: a options array of the method and the posted data array. The event should return array of type {} which extends the postdata array. onclickSubmit : function(params, posdata) { … return {add_data} }

The event (can) fire when error occurs from the ajax call and can be used for better formatting of the error messages. To this event is passed response from the server. The event should return single message (not array), which then is displayed to the user.

fires only once when creating the data for editing and adding. Receives, as parameter, the id of the constructed form. onInitializeForm : function(formid) {…}

If set this event can serialize the data passed to the ajax request when we save a form data. The function should return the serialized data. This event can be used when a custom data should be passed to the server - e.g - JSON string, XML string and etc. To this event is passed the data which will be posted to the server

when set to true the form is recreated every time the dialog is activeted with the new options from colModel (if they are changed)

reload grid data after posting

The confirmation message on save

Note
Set the text to override the text from language file.

Determines the icon of the submit button. The default value is [true,”left”,”ui-icon-disk”]. The first item enables/disables the icon. The second item tells where to put the icon to left or to right of the text. The third item corresponds to valid ui icon from theme roller

Determines the possibility to save the form with pressing a certain key.The first item enables/disables saving with pressing certain key. The second item corresponds to key code for saving. If enabled the default value for saving is [Enter]. Note that this binding should be used for both adding and editing a row. Since the binding is for the form, there is no possibility to have one key in add and another in edit mode.

When set this information is placed just after the modal header as additional row

url where to post data. If set, replaces the editurl

This option enable or disable the appearing of the previous and next buttons (pager buttons) in the form