Defines common functionality for controls that are hosted within cells of a DataGridView.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Thetype exposes the following members.
|EditingControlDataGridView||Gets or sets the DataGridView that contains the cell.|
|EditingControlFormattedValue||Gets or sets the formatted value of the cell being modified by the editor.|
|EditingControlRowIndex||Gets or sets the index of the hosting cell's parent row.|
|EditingControlValueChanged||Gets or sets a value indicating whether the value of the editing control differs from the value of the hosting cell.|
|EditingPanelCursor||Gets the cursor used when the mouse pointer is over the DataGridView.EditingPanel but not over the editing control.|
|RepositionEditingControlOnValueChange||Gets or sets a value indicating whether the cell contents need to be repositioned whenever the value changes.|
|ApplyCellStyleToEditingControl||Changes the control's user interface (UI) to be consistent with the specified cell style.|
|EditingControlWantsInputKey||Determines whether the specified key is a regular input key that the editing control should process or a special key that the DataGridView should process.|
|GetEditingControlFormattedValue||Retrieves the formatted value of the cell.|
|PrepareEditingControlForEdit||Prepares the currently selected cell for editing.|
This interface is implemented by controls, such as DataGridViewComboBoxEditingControl and DataGridViewTextBoxEditingControl, that are hosted by corresponding DataGridView cells, such as DataGridViewComboBoxCell and DataGridViewTextBoxCell, when they are in edit mode.
The DataGridView control creates an instance of the editing control type.
The DataGridView control calls the editing control ApplyCellStyleToEditingControl method and passes in the cell's current style. You can implement this method to initialize the appearance of the editing control so that it matches the appearance of the cell.
The DataGridView control calls the editing control PrepareEditingControlForEdit method. You can implement this method to make final adjustments to the editing control, such as selecting the control value.
For more information about implementing , see How to: Host Controls in Windows Forms DataGridView Cells.
Cell types such as DataGridViewCheckBoxCell that provide a user interface (UI) for specifying values without hosting an editing control implement the IDataGridViewEditingCell interface. The UI in this case is displayed regardless of whether the cell is in edit mode.
Other cell types, such as DataGridViewButtonCell, provide a UI but do not store user-specified values. In this case, the cell type does not implement IDataGridViewEditingCell or host an editing control.
The following code example provides an implementation of this interface that derives from DateTimePicker. This example is part of a larger example available in How to: Host Controls in Windows Forms DataGridView Cells.
Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.