DataGridViewComboBoxEditingControl 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示 DataGridViewComboBoxCell 中承载的组合框控件。
public ref class DataGridViewComboBoxEditingControl : System::Windows::Forms::ComboBox, System::Windows::Forms::IDataGridViewEditingControl[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public class DataGridViewComboBoxEditingControl : System.Windows.Forms.ComboBox, System.Windows.Forms.IDataGridViewEditingControlpublic class DataGridViewComboBoxEditingControl : System.Windows.Forms.ComboBox, System.Windows.Forms.IDataGridViewEditingControl[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type DataGridViewComboBoxEditingControl = class
inherit ComboBox
interface IDataGridViewEditingControltype DataGridViewComboBoxEditingControl = class
inherit ComboBox
interface IDataGridViewEditingControlPublic Class DataGridViewComboBoxEditingControl
Inherits ComboBox
Implements IDataGridViewEditingControl- 继承
- 属性
- 实现
示例
下面的代码示例演示如何使用 DataGridView.EditingControlShowing 事件处理程序为事件添加处理程序 DataGridViewComboBoxEditingControl 。 在示例中，将编辑控件强制转换为 以 ComboBox 处理 ComboBox.SelectedIndexChanged 事件。
private DataGridView dataGridView1 = new DataGridView();
private void AddColorColumn()
{
DataGridViewComboBoxColumn comboBoxColumn =
new DataGridViewComboBoxColumn();
comboBoxColumn.Items.AddRange(
Color.Red, Color.Yellow, Color.Green, Color.Blue);
comboBoxColumn.ValueType = typeof(Color);
dataGridView1.Columns.Add(comboBoxColumn);
dataGridView1.EditingControlShowing +=
new DataGridViewEditingControlShowingEventHandler(
dataGridView1_EditingControlShowing);
}
private void dataGridView1_EditingControlShowing(object sender,
DataGridViewEditingControlShowingEventArgs e)
{
ComboBox combo = e.Control as ComboBox;
if (combo != null)
{
// Remove an existing event-handler, if present, to avoid
// adding multiple handlers when the editing control is reused.
combo.SelectedIndexChanged -=
new EventHandler(ComboBox_SelectedIndexChanged);
// Add the event handler.
combo.SelectedIndexChanged +=
new EventHandler(ComboBox_SelectedIndexChanged);
}
}
private void ComboBox_SelectedIndexChanged(object sender, EventArgs e)
{
((ComboBox)sender).BackColor = (Color)((ComboBox)sender).SelectedItem;
}
Private WithEvents dataGridView1 As New DataGridView()
Private Sub AddColorColumn()
Dim comboBoxColumn As New DataGridViewComboBoxColumn()
comboBoxColumn.Items.AddRange( _
Color.Red, Color.Yellow, Color.Green, Color.Blue)
comboBoxColumn.ValueType = GetType(Color)
dataGridView1.Columns.Add(comboBoxColumn)
End Sub
Private Sub dataGridView1_EditingControlShowing(ByVal sender As Object, _
ByVal e As DataGridViewEditingControlShowingEventArgs) _
Handles dataGridView1.EditingControlShowing
Dim combo As ComboBox = CType(e.Control, ComboBox)
If (combo IsNot Nothing) Then
' Remove an existing event-handler, if present, to avoid
' adding multiple handlers when the editing control is reused.
RemoveHandler combo.SelectedIndexChanged, _
New EventHandler(AddressOf ComboBox_SelectedIndexChanged)
' Add the event handler.
AddHandler combo.SelectedIndexChanged, _
New EventHandler(AddressOf ComboBox_SelectedIndexChanged)
End If
End Sub
Private Sub ComboBox_SelectedIndexChanged( _
ByVal sender As Object, ByVal e As EventArgs)
Dim comboBox1 As ComboBox = CType(sender, ComboBox)
comboBox1.BackColor = _
CType(CType(sender, ComboBox).SelectedItem, Color)
End Sub
注解
类DataGridViewComboBoxEditingControl是实现 接口的IDataGridViewEditingControl专用类型ComboBox，允许在单元格处于编辑模式时将其托管在 DataGridViewComboBoxCell 中。 DataGridViewComboBoxCell当 处于编辑模式时，可以通过 控件的 DataGridView 属性检索 DataGridViewComboBoxEditingControlEditingControl 。
处理 事件以 EditingControlShowing 在单元格进入编辑模式时执行编辑控件的自定义初始化。 若要自定义控件的显示特征，请设置 属性返回 DataGridViewEditingControlShowingEventArgs.CellStyle 的 对象的属性，而不是设置 属性返回的控件的属性 DataGridViewEditingControlShowingEventArgs.Control 。
构造函数
| DataGridViewComboBoxEditingControl() |
初始化 DataGridViewComboBoxEditingControl 类的新实例。 |
属性
| AccessibilityObject |
获取分配给该控件的 AccessibleObject。 (继承自 Control) |
| AccessibleDefaultActionDescription |
获取或设置控件的默认操作说明以供具有辅助功能的客户端应用程序使用。 (继承自 Control) |
| AccessibleDescription |
获取或设置辅助功能客户端应用程序使用的控件说明。 (继承自 Control) |
| AccessibleName |
获取或设置辅助功能客户端应用程序所使用的控件名称。 (继承自 Control) |
| AccessibleRole |
获取或设置控件的辅助性角色。 (继承自 Control) |
| AllowDrop |
获取或设置一个值，该值指示控件是否可以接受用户拖放到它上面的数据。 (继承自 Control) |
| AllowSelection |
获取一个值，该值指示列表是否启用列表项的选择。 (继承自 ListControl) |
| Anchor |
获取或设置控件绑定到的容器的边缘并确定控件如何随其父级一起调整大小。 (继承自 Control) |
| AutoCompleteCustomSource |
获取或设置一个自定义 StringCollection，以便在 AutoCompleteSource 属性被设置为 |
| AutoCompleteMode |
获取或设置一个选项，该选项控制自动完成应用于 ComboBox 的方式。 (继承自 ComboBox) |
| AutoCompleteSource |
获取或设置一个值，该值指定用于自动完成的完整字符串的源。 (继承自 ComboBox) |
| AutoScrollOffset |
获取或设置一个值，该值指示在 ScrollControlIntoView(Control) 中将控件滚动到何处。 (继承自 Control) |
| AutoSize |
此属性与此类无关。 (继承自 Control) |
| BackColor |
获取或设置控件的背景色。 (继承自 ComboBox) |
| BackgroundImage |
此属性与此类无关。 (继承自 ComboBox) |
| BackgroundImageLayout |
获取或设置在 ImageLayout 枚举中定义的背景图像布局。 (继承自 ComboBox) |
| BindingContext |
获取或设置控件的 BindingContext。 (继承自 Control) |
| Bottom |
获取控件下边缘与其容器的工作区上边缘之间的距离（以像素为单位）。 (继承自 Control) |
| Bounds |
获取或设置控件（包括其非工作区元素）相对于其父控件的大小和位置（以像素为单位）。 (继承自 Control) |
| CanEnableIme |
获取一个用以指示是否可以将 ImeMode 属性设置为活动值的值，以启用 IME 支持。 (继承自 Control) |
| CanFocus |
获取一个值，该值指示控件是否可以接收焦点。 (继承自 Control) |
| CanRaiseEvents |
确定是否可以在控件上引发事件。 (继承自 Control) |
| CanSelect |
获取一个值，该值指示是否可以选中控件。 (继承自 Control) |
| Capture |
获取或设置一个值，该值指示控件是否已捕获鼠标。 (继承自 Control) |
| CausesValidation |
获取或设置一个值，该值指示控件是否会引起在任何需要在接收焦点时执行验证的控件上执行验证。 (继承自 Control) |
| ClientRectangle |
获取表示控件的工作区的矩形。 (继承自 Control) |
| ClientSize |
获取或设置控件的工作区的高度和宽度。 (继承自 Control) |
| CompanyName |
获取包含控件的应用程序的公司名称或创建者。 (继承自 Control) |
| Container |
获取包含 IContainer 的 Component。 (继承自 Component) |
| ContainsFocus |
获取一个值，该值指示控件或它的一个子控件当前是否有输入焦点。 (继承自 Control) |
| ContextMenu |
获取或设置与控件关联的快捷菜单。 (继承自 Control) |
| ContextMenuStrip |
获取或设置与此控件关联的 ContextMenuStrip。 (继承自 Control) |
| Controls |
获取包含在控件内的控件的集合。 (继承自 Control) |
| Created |
获取一个值，该值指示控件是否已经创建。 (继承自 Control) |
| CreateParams |
获取创建控件句柄时所需要的创建参数。 (继承自 ComboBox) |
| Cursor |
获取或设置当鼠标指针位于控件上时显示的光标。 (继承自 Control) |
| DataBindings |
为该控件获取数据绑定。 (继承自 Control) |
| DataContext |
获取或设置用于数据绑定的数据上下文。 这是一个环境属性。 (继承自 Control) |
| DataManager |
获取与此控件关联的 CurrencyManager。 (继承自 ListControl) |
| DataSource |
获取或设置此 ComboBox 的数据源。 (继承自 ComboBox) |
| DefaultCursor |
获取或设置控件的默认光标。 (继承自 Control) |
| DefaultImeMode |
获取控件支持的默认输入法编辑器 (IME) 模式。 (继承自 Control) |
| DefaultMargin |
获取控件之间默认指定的间距（以像素为单位）。 (继承自 Control) |
| DefaultMaximumSize |
获取以像素为单位的长度和高度，此长度和高度被指定为控件的默认最大大小。 (继承自 Control) |
| DefaultMinimumSize |
获取以像素为单位的长度和高度，此长度和高度被指定为控件的默认最小大小。 (继承自 Control) |
| DefaultPadding |
获取控件内容的默认内部间距（以像素为单位）。 (继承自 Control) |
| DefaultSize |
获取控件的默认大小。 (继承自 ComboBox) |
| DesignMode |
获取一个值，用以指示 Component 当前是否处于设计模式。 (继承自 Component) |
| DeviceDpi |
获取显示当前控件的显示设备的 DPI 值。 (继承自 Control) |
| DisplayMember |
获取或设置要为此 ListControl 显示的属性。 (继承自 ListControl) |
| DisplayRectangle |
获取表示控件的显示区域的矩形。 (继承自 Control) |
| Disposing |
获取一个值，该值指示 Control 基类是否在释放进程中。 (继承自 Control) |
| Dock |
获取或设置哪些控件边框停靠到其父控件并确定控件如何随其父级一起调整大小。 (继承自 Control) |
| DoubleBuffered |
获取或设置一个值，该值指示此控件是否应使用辅助缓冲区重绘其图面，以减少或避免闪烁。 (继承自 Control) |
| DrawMode |
获取或设置一个值，该值指示指示代码或操作系统是否会处理列表中的元素的绘制。 (继承自 ComboBox) |
| DropDownHeight |
获取或设置 ComboBox 的下拉部分的高度（以像素为单位）。 (继承自 ComboBox) |
| DropDownStyle |
获取或设置指定组合框样式的值。 (继承自 ComboBox) |
| DropDownWidth |
获取或设置组合框下拉部分的宽度。 (继承自 ComboBox) |
| DroppedDown |
获取或设置一个值，该值指示组合框是否正在显示其下拉部分。 (继承自 ComboBox) |
| EditingControlDataGridView |
获取或设置包含组合框控件的 DataGridView。 |
| EditingControlFormattedValue |
获取或设置此控件的当前值的格式化表示形式。 |
| EditingControlRowIndex |
获取或设置所属单元格的父行的索引。 |
| EditingControlValueChanged |
获取或设置一个值，用于指示控件的当前值是否已更改。 |
| EditingPanelCursor |
获取编辑期间使用的光标。 |
| Enabled |
获取或设置一个值，该值指示控件是否可以对用户交互作出响应。 (继承自 Control) |
| Events |
获取附加到此 Component 的事件处理程序的列表。 (继承自 Component) |
| FlatStyle |
获取或设置 ComboBox 的外观。 (继承自 ComboBox) |
| Focused |
获取一个值，该值指示 ComboBox 是否具有焦点。 (继承自 ComboBox) |
| Font |
获取或设置控件显示的文字的字体。 (继承自 Control) |
| FontHeight |
获取或设置控件的字体的高度。 (继承自 Control) |
| ForeColor |
获取或设置控件的前景色。 (继承自 ComboBox) |
| FormatInfo |
获取或设置提供自定义格式设置行为的 IFormatProvider。 (继承自 ListControl) |
| FormatString |
获取或设置指示显示值的方式的格式说明符字符。 (继承自 ListControl) |
| FormattingEnabled |
获取或设置一个值，该值指示是否将格式设置应用于 DisplayMember 的 ListControl 属性。 (继承自 ListControl) |
| Handle |
获取控件绑定到的窗口句柄。 (继承自 Control) |
| HasChildren |
获取一个值，该值指示控件是否包含一个或多个子控件。 (继承自 Control) |
| Height |
获取或设置控件的高度。 (继承自 Control) |
| ImeMode |
获取或设置控件的输入法编辑器 (IME) 模式。 (继承自 Control) |
| ImeModeBase |
获取或设置控件的 IME 模式。 (继承自 Control) |
| IntegralHeight |
获取或设置一个值，该值指示控件是否应调整大小以避免只显示项的局部。 (继承自 ComboBox) |
| InvokeRequired |
获取一个值，该值指示调用方在对控件进行方法调用时是否必须调用 Invoke 方法，因为调用方位于创建控件所在的线程以外的线程中。 (继承自 Control) |
| IsAccessible |
获取或设置一个值，该值指示控件对辅助功能应用程序是否可见。 (继承自 Control) |
| IsAncestorSiteInDesignMode |
指示此控件的上级之一是否位于 DesignMode 中以及该站点。 此属性为只读。 (继承自 Control) |
| IsDisposed |
获取一个值，该值指示控件是否已经被释放。 (继承自 Control) |
| IsHandleCreated |
获取一个值，该值指示控件是否有与它关联的句柄。 (继承自 Control) |
| IsMirrored |
获取一个值，该值指示此控件是否为镜像控件。 (继承自 Control) |
| ItemHeight |
获取或设置组合框中的某项的高度。 (继承自 ComboBox) |
| Items |
获取一个对象，该对象表示此 ComboBox 中所含的项的集合。 (继承自 ComboBox) |
| LayoutEngine |
获取控件的布局引擎的缓存实例。 (继承自 Control) |
| Left |
获取或设置控件左边缘与其容器的工作区左边缘之间的距离（以像素为单位）。 (继承自 Control) |
| Location |
获取或设置该控件的左上角相对于其容器的左上角的坐标。 (继承自 Control) |
| Margin |
获取或设置控件之间的空间。 (继承自 Control) |
| MaxDropDownItems |
获取或设置要在 ComboBox 的下拉部分中显示的最大项数。 (继承自 ComboBox) |
| MaximumSize |
获取或设置 GetPreferredSize(Size) 方法可指定的上限大小。 (继承自 ComboBox) |
| MaxLength |
获取或设置用户可键入 ComboBox 中的字符数。 (继承自 ComboBox) |
| MinimumSize |
获取或设置 GetPreferredSize(Size) 方法可指定的下限大小。 (继承自 ComboBox) |
| Name |
获取或设置控件的名称。 (继承自 Control) |
| Padding |
此属性与此类无关。 (继承自 ComboBox) |
| Parent |
获取或设置控件的父容器。 (继承自 Control) |
| PreferredHeight |
获取 ComboBox 的首选高度。 (继承自 ComboBox) |
| PreferredSize |
获取可以容纳控件的矩形区域的大小。 (继承自 Control) |
| ProductName |
获取包含控件的程序集的产品名称。 (继承自 Control) |
| ProductVersion |
获取包含控件的程序集的版本。 (继承自 Control) |
| RecreatingHandle |
获取一个值，该值指示控件当前是否在重新创建其句柄。 (继承自 Control) |
| Region |
获取或设置与控件关联的窗口区域。 (继承自 Control) |
| RenderRightToLeft |
已过时.
已过时.
此属性现已过时。 (继承自 Control) |
| RepositionEditingControlOnValueChange |
获取一个值，指示是否需要在每次值更改时重新定位单元格内容。 |
| ResizeRedraw |
获取或设置一个值，该值指示控件在调整大小时是否重绘自己。 (继承自 Control) |
| Right |
获取控件右边缘与其容器的工作区左边缘之间的距离（以像素为单位）。 (继承自 Control) |
| RightToLeft |
获取或设置一个值，该值指示是否将控件的元素对齐以支持使用从右向左的字体的区域设置。 (继承自 Control) |
| ScaleChildren |
获取一个值，该值确定子控件的缩放。 (继承自 Control) |
| SelectedIndex |
获取或设置指定当前选定项的索引。 (继承自 ComboBox) |
| SelectedItem |
获取或设置 ComboBox 中当前选定的项。 (继承自 ComboBox) |
| SelectedText |
获取或设置 ComboBox 的可编辑部分中选定的文本。 (继承自 ComboBox) |
| SelectedValue |
获取或设置由 ValueMember 属性指定的成员属性的值。 (继承自 ListControl) |
| SelectionLength |
获取或设置组合框可编辑部分中选定的字符数。 (继承自 ComboBox) |
| SelectionStart |
获取或设置组合框中选定文本的起始索引。 (继承自 ComboBox) |
| ShowFocusCues |
获取一个值，该值指示控件是否应显示聚焦框。 (继承自 Control) |
| ShowKeyboardCues |
获取一个值，该值指示用户界面是否处于适当的状态以显示或隐藏键盘快捷键。 (继承自 Control) |
| Site |
获取或设置控件的站点。 (继承自 Control) |
| Size |
获取或设置控件的高度和宽度。 (继承自 Control) |
| Sorted |
获取或设置指示是否对组合框中的项进行了排序的值。 (继承自 ComboBox) |
| TabIndex |
获取或设置控件在其容器内的 Tab 键顺序。 (继承自 Control) |
| TabStop |
获取或设置一个值，该值指示用户能否使用 Tab 键将焦点放到该控件上。 (继承自 Control) |
| Tag |
获取或设置包含有关控件的数据的对象。 (继承自 Control) |
| Text |
获取或设置与此控件关联的文本。 (继承自 ComboBox) |
| Top |
获取或设置控件上边缘与其容器的工作区上边缘之间的距离（以像素为单位）。 (继承自 Control) |
| TopLevelControl |
获取没有另一个 Windows 窗体控件作为其父级的父控件。 通常，这是控件所在的最外面的 Form。 (继承自 Control) |
| UseWaitCursor |
获取或设置一个值，该值指示是否将等待光标用于当前控件以及所有子控件。 (继承自 Control) |
| ValueMember |
获取或设置属性的路径，它将用作 ListControl 中的项的实际值。 (继承自 ListControl) |
| Visible |
获取或设置一个值，该值指示是否显示该控件及其所有子控件。 (继承自 Control) |
| Width |
获取或设置控件的宽度。 (继承自 Control) |
| WindowTarget |
此属性与此类无关。 (继承自 Control) |
方法
事件
显式接口实现
| IDropTarget.OnDragDrop(DragEventArgs) |
引发 DragDrop 事件。 (继承自 Control) |
| IDropTarget.OnDragEnter(DragEventArgs) |
引发 DragEnter 事件。 (继承自 Control) |
| IDropTarget.OnDragLeave(EventArgs) |
引发 DragLeave 事件。 (继承自 Control) |
| IDropTarget.OnDragOver(DragEventArgs) |
引发 DragOver 事件。 (继承自 Control) |
