Tile Editing
- 2 minutes to read
In the Tile View, tiles can provide the editing functionality using a separate Edit Form. To enable tile editing, set the GridOptionsBehavior.EditingMode (TileView.OptionsBehavior.EditingMode) property to the EditForm value.
At runtime, when an end-user double-clicks a tile, or focuses it and then presses ENTER or F2, the Tile View invokes the modal Edit Form containing data from the current tile.
The Tile View automatically generates a layout of fields within the Edit Form, according to the settings provided by the TileView.OptionsEditForm and GridColumn.OptionsEditForm properties. These settings allow you to specify the number of layout columns, field visibility and order, etc.
If the default layout of the Edit Form does not meet your requirements, you can create a custom Edit Form (UserControl), which will arrange editors in a specific manner. Create a User Control derived from the EditFormUserControl class, and assign an instance of this User Control to the TileView.OptionsEditForm.CustomEditFormLayout property. For more information, see Modify and Validate Cell Values.
The following events can be useful when you dynamically customize Edit Forms.
- TileView.EditFormShowing - Occurs when an Edit Form is about to be displayed, and allows you to cancel the action.
- TileView.EditFormPrepared - Allows you to customize the Edit Form that is about to be displayed.
- TileView.ShowingPopupEditForm - Occurs when an Edit Form is about to be displayed as a separate modal window.