Properties described in this chapter define which actions are available to the end user. It is defined whether the user is capable to add new records, to stroll through the data source, to remove and save data, etc. Properties can be used to customize the user interface so that an application can be created that suits every desire of even the most demanded customer.
Each property can contains any of the three navigation button states. It is possible to define that a button is visible; the user can avail of its functionality. A button can be disabled; button is visible but user cannot use it. Third option is that the button is hidden and cannot be seen by a user. To learn more about the states see Navigation Button States chapter.
Property | Description |
---|---|
Add | Open the control in edit mode in order for a new record to be inserted. The values of all fields are empty in no default values are defined or editors attached. |
CancelEdit | Leaves the edit mode in the control. Any possible changes are not saved. |
Copy | Opens the control in edit mode for inserting new records. Fields however are not empty. They contain data from previously selected record. Value is only transferred to the new record, if field’s Cloneable property is set to True. |
Edit | Opens control in edit mode where it is possible to edit currently selected data. |
EndEdit | Leaves the edit mode in the control. All changes are saved using either insert or update statement. |
MoveFirst | Moves to the first record in the data source. If current display is out of visible range, the control strolls to the beginning. The first record is selected. |
MoveLast | Moves to the last record in the data source. If current display is out of visible range, the control strolls to the end. The last record is selected. |
MoveNext | Moves to the next record in the data source. The next record is automatically selected. |
MovePrevious | Moves to the previous record in the data source. One record before the current is selected and not previously selected record. |
Refresh | Refreshes the data in the control. Select statement is executed therefore all the data is reloaded. |
Remove | Removes the currently selected record in the control. In order to delete data, delete statement is executed. |
Save | Saves unsaved changes in the grid. Option is only available when AutoSave property of the data source is set to False. In this case upon EndEdit click the insert or update statements are not executed immediately, but upon a click on the Save option. |