TileViewOptionsBehavior.EditingMode Property

Gets or sets whether and how tiles can be edited.

Namespace: DevExpress.XtraGrid.Views.Tile

Assembly: DevExpress.XtraGrid.v23.2.dll

NuGet Packages: DevExpress.Win.Grid, DevExpress.Win.Navigation

Declaration

C#

[DefaultValue(TileViewEditingMode.HtmlTemplate)]
[XtraSerializableProperty]
public TileViewEditingMode EditingMode { get; set; }

VB.NET

<DefaultValue(TileViewEditingMode.HtmlTemplate)>
<XtraSerializableProperty>
Public Property EditingMode As TileViewEditingMode

Property Value

Type	Default	Description
TileViewEditingMode	HtmlTemplate	A value that specifies whether and how tiles can be edited.

Available values:

Name	Description
Disabled	Edit operations are disabled.
EditForm	Users can edit tiles in a modal Edit Form.
HtmlTemplate	Allows you to display in-place editors for tile elements if you use HTML-CSS templates to render tiles. Use the <input> tag to specify an in-place editor (repository item). See the following topic for more information: Tile View - HTML and CSS-based Tile Template.

Property Paths

You can access this nested property as listed below:

Object Type	Path to EditingMode
TileView	.OptionsBehavior .EditingMode

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.