A newer version of this page is available. Switch to the current version.

TileView.EditFormPrepared Event

Allows you to customize the Edit Form that is about to be displayed.

Namespace: DevExpress.XtraGrid.Views.Tile

Assembly: DevExpress.XtraGrid.v19.1.dll

Declaration

[DXCategory("Editor")]
public event EditFormPreparedEventHandler EditFormPrepared

Event Data

The EditFormPrepared event's data class is EditFormPreparedEventArgs. The following properties provide information specific to this event:

Property Description
BindableControls Provides access to the collection of controls used to edit fields of the processed data record, which are indexed by field names or grid columns.
Panel Gets the container that arranges editors and buttons on the Edit Form.
RowHandle Gets the handle that identifies the grid row for which the Edit From is about to be displayed.

The event data class exposes the following methods:

Method Description
FocusField(GridColumn) Sets input focus to the editor that corresponds to the specified GridColumn.
FocusField(String) Sets input focus to the editor that corresponds to the grid column with the specified GridColumn.FieldName.

Remarks

You can handle the EditFormPrepared event to manipulate the Edit Form that is about to be displayed. To get the handle that identifies a grid row for which the Edit Form is about to be displayed, use the EditFormPreparedEventArgs.RowHandle event argument. The EditFormPreparedEventArgs.BindableControls property provides access to the collection of editors on the Edit Form that are bound to the underlying data source.

While handling the EditFormPrepared event, you can focus a specific editor using the EditFormPreparedEventArgs.FocusField method.

Before the EditFormPrepared event, the TileView.EditFormShowing event fires, allowing you to cancel the action.

See Also