IDataGridViewEditingControl (Interfaz)
Actualización: noviembre 2007
Define una funcionalidad común para los controles que se alojan en las celdas de un control DataGridView.
Ensamblado: System.Windows.Forms (en System.Windows.Forms.dll)
Cuando se encuentran en modo de edición, los controles, como DataGridViewComboBoxEditingControl y DataGridViewTextBoxEditingControl, incluidos en las celdas de DataGridView correspondientes, como DataGridViewComboBoxCell y DataGridViewTextBoxCell, implementan esta interfaz.
Los tipos de celdas que pueden alojar controles de edición establecen su propiedad EditType en un valor Type que representa el tipo de control de edición. Cuando la celda entra en el modo de edición, se realizan los pasos siguientes:
-
El control DataGridView crea una instancia del tipo de control de edición.
-
El control DataGridView llama al método InitializeEditingControl de la celda. Puede reemplazar este método para transferir el valor de la celda al control de edición.
-
El control DataGridView llama al método ApplyCellStyleToEditingControl del control de edición y pasa el estilo actual de la celda. Puede implementar este método para inicializar la apariencia del control de edición de forma que coincida con la apariencia de la celda.
-
El control DataGridView llama al método PrepareEditingControlForEdit del control de edición. Puede implementar este método para realizar ajustes finales en el control de edición, como seleccionar el valor del control.
Para obtener más información sobre la implementación de IDataGridViewEditingControl, vea Cómo: Alojar controles en celdas DataGridView de formularios Windows Forms.
Los tipos de celdas, como DataGridViewCheckBoxCell, que proporcionan una interfaz de usuario que permite especificar valores sin necesidad de alojar un control de edición, implementan la interfaz IDataGridViewEditingCell. En este caso, la interfaz de usuario aparece con independencia de si la celda se encuentra o no en modo de edición.
Otros tipos de celdas, como DataGridViewButtonCell, proporcionan una interfaz de usuario, pero no almacenan valores especificados por el usuario. En este caso, el tipo de celda no implementa la interfaz IDataGridViewEditingCell ni aloja controles de edición.
En el ejemplo de código siguiente se proporciona una implementación de esta interfaz que se deriva de DateTimePicker. Este ejemplo forma parte de un ejemplo más extenso proporcionado en Cómo: Alojar controles en celdas DataGridView de formularios Windows Forms.
class CalendarEditingControl : DateTimePicker, IDataGridViewEditingControl { DataGridView dataGridView; private bool valueChanged = false; int rowIndex; public CalendarEditingControl() { this.Format = DateTimePickerFormat.Short; } // Implements the IDataGridViewEditingControl.EditingControlFormattedValue // property. public object EditingControlFormattedValue { get { return this.Value.ToShortDateString(); } set { if (value is String) { this.Value = DateTime.Parse((String)value); } } } // Implements the // IDataGridViewEditingControl.GetEditingControlFormattedValue method. public object GetEditingControlFormattedValue( DataGridViewDataErrorContexts context) { return EditingControlFormattedValue; } // Implements the // IDataGridViewEditingControl.ApplyCellStyleToEditingControl method. public void ApplyCellStyleToEditingControl( DataGridViewCellStyle dataGridViewCellStyle) { this.Font = dataGridViewCellStyle.Font; this.CalendarForeColor = dataGridViewCellStyle.ForeColor; this.CalendarMonthBackground = dataGridViewCellStyle.BackColor; } // Implements the IDataGridViewEditingControl.EditingControlRowIndex // property. public int EditingControlRowIndex { get { return rowIndex; } set { rowIndex = value; } } // Implements the IDataGridViewEditingControl.EditingControlWantsInputKey // method. public bool EditingControlWantsInputKey( Keys key, bool dataGridViewWantsInputKey) { // Let the DateTimePicker handle the keys listed. switch (key & Keys.KeyCode) { case Keys.Left: case Keys.Up: case Keys.Down: case Keys.Right: case Keys.Home: case Keys.End: case Keys.PageDown: case Keys.PageUp: return true; default: return !dataGridViewWantsInputKey; } } // Implements the IDataGridViewEditingControl.PrepareEditingControlForEdit // method. public void PrepareEditingControlForEdit(bool selectAll) { // No preparation needs to be done. } // Implements the IDataGridViewEditingControl // .RepositionEditingControlOnValueChange property. public bool RepositionEditingControlOnValueChange { get { return false; } } // Implements the IDataGridViewEditingControl // .EditingControlDataGridView property. public DataGridView EditingControlDataGridView { get { return dataGridView; } set { dataGridView = value; } } // Implements the IDataGridViewEditingControl // .EditingControlValueChanged property. public bool EditingControlValueChanged { get { return valueChanged; } set { valueChanged = value; } } // Implements the IDataGridViewEditingControl // .EditingPanelCursor property. public Cursor EditingPanelCursor { get { return base.Cursor; } } protected override void OnValueChanged(EventArgs eventargs) { // Notify the DataGridView that the contents of the cell // have changed. valueChanged = true; this.EditingControlDataGridView.NotifyCurrentCellDirty(true); base.OnValueChanged(eventargs); } }
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.