Concepts.Editable and ReadOnly 
Preparing...
The user can directly update values during the run time by using cell editor or editable cell renderer, pasting clipboard, clearing selected area, etc. In particular, you can only display cell editor to check the hidden part rather than to update the value. At this point, because of grid UI characteristic, you may need to manage the availability of user update and editor display in each data column, data row or data cell level in detail, and in order to manage the availability of editor display in a specific data cell through editable and the availability of user update of cell value through readOnly, SMART datagrid provides the property, callback function and event in many locations.
1. editable
Check editable state of the corresponding cell before displaying the editor in the cell. If check the paths below in the order and become false, the editor will not be displayed.
| Property | Default value | Explanation |
|---|---|---|
| GridBase.readMode | false | If it is true, you will not be able to edit or update in all cells regardless of other settings. In other words, it will become not editable in all cells. |
| EditOptions.editable | true | If specify as false, all cells will become not editable regardless of other settings. |
| DataColumn.editableCallback | null | If explicitly return Boolean false or true within this callback function, editable will be determined by that value and the rest decision procedure will be cancelled. If do not return the value, it will run the next decision stage. |
| EditOptions.editableCallback | null | It will be run in the same way of column callback as above. |
| DataColumn.editable | true | If specify as false, cells being included in this column will become not editable. |
| EditOptions.fixedColumnEditable | true | If specify as false, cells being included in Fixed Columns will become not editable. |
| EditOptions.fixedRowEditable | true | If specify as false, cells being included in Fixed Rows will become not editable. |
| EditOptions.deletedRowEditable | false | If specify as true, cells being included in Deleted rows will become editable. |
2. readOnly
Check readOnly state before updating the value in the cell to be edited by using editor and renderer, pasting, clearing the selected area, etc. If check the paths below in the order and become true, the value will not be updated.
| Property | Default value | Explanation |
|---|---|---|
| GridBase.readMode | false | If it is true, you will not be able to edit or update in all cells regardless of other settings. In other words, it will become readOnly in all cells. |
| EditOptions.readOnly | false | If specify as true, all cells will become readOnly regardless of other settings. And, you will not be able to do row updating, appending, deleting. |
| DataField.updatable | false | If data field being connected to edit cell is not updatable or updatable is false, it will become readOnly. |
| DataColumn.readOnlyCallback | null | If explicitly return Boolean false or true within this callback function, readOnly will be determined by that value and the rest decision procedure will be cancelled. If do not return the value, it will run the next decision stage. |
| EditOptions.readOnlyCallback | null | It will be run in the same way of column callback as above. |
| DataColumn.readOnly | false | If specify as true, cells being included in this column will become readOnly. |
| EditOptions.fixedColumnReadOnly | false | If specify as true, cells being included in Fixed Columns will become readOnly. |
| EditOptions.fixedRowReadOnly | false | If specify as true, cells being included in Fixed Rows will become readOnly. |
| EditOptions.deletedRowReadOnly | true | If specify as true, cells being included in Deleted rows will become readOnly. |
- See Also
- Cell Editing Overview
- Examples
- ReadOnly & Editable