IDataGridViewEditingControl Arabirim
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
bir hücrelerinde DataGridViewbarındırılan denetimler için ortak işlevselliği tanımlar.
public interface class IDataGridViewEditingControlpublic interface IDataGridViewEditingControltype IDataGridViewEditingControl = interfacePublic Interface IDataGridViewEditingControl- Türetilmiş
Örnekler
Aşağıdaki kod örneği, bu arabirimin uygulamasından DateTimePickertüretilen bir uygulama sağlar. Bu örnek, Nasıl yapılır: Windows Forms DataGridView Hücrelerinde Denetimleri Barındırma bölümünde bulunan daha büyük bir örneğin parçasıdır.
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)
{
try
{
// This will throw an exception of the string is
// null, empty, or not in the format of a date.
this.Value = DateTime.Parse((String)value);
}
catch
{
// In the case of an exception, just use the
// default value so we're not left with a null
// value.
this.Value = DateTime.Now;
}
}
}
}
// 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);
}
}
Class CalendarEditingControl
Inherits DateTimePicker
Implements IDataGridViewEditingControl
Private dataGridViewControl As DataGridView
Private valueIsChanged As Boolean = False
Private rowIndexNum As Integer
Public Sub New()
Me.Format = DateTimePickerFormat.Short
End Sub
Public Property EditingControlFormattedValue() As Object _
Implements IDataGridViewEditingControl.EditingControlFormattedValue
Get
Return Me.Value.ToShortDateString()
End Get
Set(ByVal value As Object)
Try
' This will throw an exception of the string is
' null, empty, or not in the format of a date.
Me.Value = DateTime.Parse(CStr(value))
Catch
' In the case of an exception, just use the default
' value so we're not left with a null value.
Me.Value = DateTime.Now
End Try
End Set
End Property
Public Function GetEditingControlFormattedValue(ByVal context _
As DataGridViewDataErrorContexts) As Object _
Implements IDataGridViewEditingControl.GetEditingControlFormattedValue
Return Me.Value.ToShortDateString()
End Function
Public Sub ApplyCellStyleToEditingControl(ByVal dataGridViewCellStyle As _
DataGridViewCellStyle) _
Implements IDataGridViewEditingControl.ApplyCellStyleToEditingControl
Me.Font = dataGridViewCellStyle.Font
Me.CalendarForeColor = dataGridViewCellStyle.ForeColor
Me.CalendarMonthBackground = dataGridViewCellStyle.BackColor
End Sub
Public Property EditingControlRowIndex() As Integer _
Implements IDataGridViewEditingControl.EditingControlRowIndex
Get
Return rowIndexNum
End Get
Set(ByVal value As Integer)
rowIndexNum = value
End Set
End Property
Public Function EditingControlWantsInputKey(ByVal key As Keys, _
ByVal dataGridViewWantsInputKey As Boolean) As Boolean _
Implements IDataGridViewEditingControl.EditingControlWantsInputKey
' Let the DateTimePicker handle the keys listed.
Select Case key And Keys.KeyCode
Case Keys.Left, Keys.Up, Keys.Down, Keys.Right, _
Keys.Home, Keys.End, Keys.PageDown, Keys.PageUp
Return True
Case Else
Return Not dataGridViewWantsInputKey
End Select
End Function
Public Sub PrepareEditingControlForEdit(ByVal selectAll As Boolean) _
Implements IDataGridViewEditingControl.PrepareEditingControlForEdit
' No preparation needs to be done.
End Sub
Public ReadOnly Property RepositionEditingControlOnValueChange() _
As Boolean Implements _
IDataGridViewEditingControl.RepositionEditingControlOnValueChange
Get
Return False
End Get
End Property
Public Property EditingControlDataGridView() As DataGridView _
Implements IDataGridViewEditingControl.EditingControlDataGridView
Get
Return dataGridViewControl
End Get
Set(ByVal value As DataGridView)
dataGridViewControl = value
End Set
End Property
Public Property EditingControlValueChanged() As Boolean _
Implements IDataGridViewEditingControl.EditingControlValueChanged
Get
Return valueIsChanged
End Get
Set(ByVal value As Boolean)
valueIsChanged = value
End Set
End Property
Public ReadOnly Property EditingControlCursor() As Cursor _
Implements IDataGridViewEditingControl.EditingPanelCursor
Get
Return MyBase.Cursor
End Get
End Property
Protected Overrides Sub OnValueChanged(ByVal eventargs As EventArgs)
' Notify the DataGridView that the contents of the cell have changed.
valueIsChanged = True
Me.EditingControlDataGridView.NotifyCurrentCellDirty(True)
MyBase.OnValueChanged(eventargs)
End Sub
End Class
Açıklamalar
Bu arabirim, DataGridViewComboBoxEditingControl düzenleme modundayken ve DataGridViewTextBoxEditingControlgibi karşılık gelen DataGridView hücreler tarafından barındırılan ve DataGridViewTextBoxCellgibi DataGridViewComboBoxCell denetimler tarafından uygulanır.
Düzenleme denetimlerini barındırabilen hücre türleri, kendi EditType özelliğini düzenleme denetim türünü temsil eden bir Type olarak ayarlar. Hücre düzenleme moduna girdiğinde aşağıdaki adımlar gerçekleştirilir:
Denetim, DataGridView düzenleme denetim türünün bir örneğini oluşturur.
Denetim DataGridView hücre InitializeEditingControl yöntemini çağırır. Hücre değerini düzenleme denetimine aktarmak için bu yöntemi geçersiz kılabilirsiniz.
Denetim DataGridView düzenleme denetim ApplyCellStyleToEditingControl yöntemini çağırır ve hücrenin geçerli stilini geçirir. Düzenleme denetiminin görünümünü hücrenin görünümüyle eşleşecek şekilde başlatmak için bu yöntemi uygulayabilirsiniz.
Denetim, DataGridView düzenleme denetimi PrepareEditingControlForEdit yöntemini çağırır. Denetim değerini seçme gibi düzenleme denetiminde son ayarlamaları yapmak için bu yöntemi uygulayabilirsiniz.
uygulama IDataGridViewEditingControlhakkında daha fazla bilgi için bkz. Nasıl yapılır: Windows Forms DataGridView Hücrelerinde Denetimleri Barındırma.
Düzenleme denetimi barındırmadan değerleri belirtmek için kullanıcı arabirimi (UI) sağlayan gibi DataGridViewCheckBoxCell hücre türleri arabirimini uygular IDataGridViewEditingCell . Bu durumda kullanıcı arabirimi, hücrenin düzenleme modunda olup olmadığına bakılmaksızın görüntülenir.
gibi DataGridViewButtonCelldiğer hücre türleri kullanıcı arabirimi sağlar ancak kullanıcı tarafından belirtilen değerleri depolamaz. Bu durumda, hücre türü bir düzenleme denetimi uygulamaz IDataGridViewEditingCell veya barındırmaz.
Özellikler
| EditingControlDataGridView |
Hücreyi içeren öğesini DataGridView alır veya ayarlar. |
| EditingControlFormattedValue |
Düzenleyici tarafından değiştirilen hücrenin biçimlendirilmiş değerini alır veya ayarlar. |
| EditingControlRowIndex |
Barındırma hücresinin üst satırının dizinini alır veya ayarlar. |
| EditingControlValueChanged |
Düzenleme denetiminin değerinin barındırma hücresinin değerinden farklı olup olmadığını belirten bir değer alır veya ayarlar. |
| EditingPanelCursor |
Fare işaretçisi düzenleme denetiminin üzerindeyken EditingPanel değil üzerindeyken kullanılan imleci alır. |
| RepositionEditingControlOnValueChange |
Değer her değiştiğinde hücre içeriğinin yeniden konumlandırılması gerekip gerekmediğini belirten bir değer alır veya ayarlar. |
Yöntemler
| ApplyCellStyleToEditingControl(DataGridViewCellStyle) |
Denetimin kullanıcı arabirimini (UI) belirtilen hücre stiliyle tutarlı olacak şekilde değiştirir. |
| EditingControlWantsInputKey(Keys, Boolean) |
Belirtilen anahtarın düzenleme denetiminin işlemesi gereken normal bir giriş anahtarı mı yoksa işlemesi gereken özel bir anahtar mı olduğunu DataGridView belirler. |
| GetEditingControlFormattedValue(DataGridViewDataErrorContexts) |
Hücrenin biçimlendirilmiş değerini alır. |
| PrepareEditingControlForEdit(Boolean) |
Seçili durumdaki hücreyi düzenlemeye hazırlar. |
