TileViewOptionsBehavior.EditingMode Property
Gets or sets whether and how tiles can be edited.
Namespace: DevExpress.XtraGrid.Views.Tile
Assembly: DevExpress.XtraGrid.v19.1.dll
Declaration
[DefaultValue(TileViewEditingMode.Disabled)]
[XtraSerializableProperty]
public TileViewEditingMode EditingMode { get; set; }Property Value
| Type | Default | Description |
|---|---|---|
| TileViewEditingMode | **Disabled** | A value that specifies whether and how tiles can be edited. |
Available values:
| Name | Description |
|---|---|
| Disabled | No tile editing is enabled. |
| EditForm | Tile editing is enabled using a modal Edit Form. |
Property Paths
You can access this nested property as listed below:
| Object Type | Path to EditingMode |
|---|---|
| TileView |
|
Remarks
By default, tile editing is disabled. You can enable tile editing in a modal Edit Form, by setting the EditingMode property to EditForm.
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 if you need to 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.