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 是一種特製化型 ComboBox 別，可實 IDataGridViewEditingControl 作 介面，以便在儲存格處於編輯模式時載入於 DataGridViewComboBoxCell 。 DataGridViewComboBoxCell當 處於編輯模式時，您可以透過 EditingControl 控制項的 DataGridView 屬性擷取 DataGridViewComboBoxEditingControl 。
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 |
取得或設定當 AutoCompleteSource 屬性設定為 |
| AutoCompleteMode |
取得或設定選項，控制如何在 ComboBox 中使用自動完成。 (繼承來源 ComboBox) |
| AutoCompleteSource |
取得或設定值，以指定用於自動完成的完整字串來源。 (繼承來源 ComboBox) |
| AutoScrollOffset |
取得或設定此控制項在 ScrollControlIntoView(Control) 中要捲動到哪一個位置。 (繼承來源 Control) |
| AutoSize |
這個屬性與這個類別無關。 (繼承來源 Control) |
| BackColor |
取得或設定控制項的背景色彩。 (繼承來源 ComboBox) |
| BackgroundImage |
這個屬性與這個類別無關。 (繼承來源 ComboBox) |
| BackgroundImageLayout |
取得或設定在 ImageLayout 列舉類型中所定義的背景影像配置。 (繼承來源 ComboBox) |
| BindingContext |
取得或設定控制項的 BindingContext。 (繼承來源 Control) |
| Bottom |
取得控制項下邊緣和其容器工作區 (Client Area) 上邊緣之間的距離 (單位為像素)。 (繼承來源 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 |
取得控制項的資料繫結 (Data Binding)。 (繼承來源 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 |
取得或設定值，指出這個控制項是否應使用次要緩衝區重繪其介面，以減少或防止重繪閃動 (Flicker)。 (繼承來源 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 |
取得或設定控制項左邊緣和其容器工作區 (Client Area) 左邊緣之間的距離 (單位為像素)。 (繼承來源 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 |
取得控制項右邊緣和其容器工作區 (Client Area) 左邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
| RightToLeft |
取得或設定值，指出控制項的項目是否對齊，以支援使用由右至左字型的地區設定。 (繼承來源 Control) |
| ScaleChildren |
取得值，以判斷子控制項的縮放。 (繼承來源 Control) |
| SelectedIndex |
取得或設定目前選取項目的索引。 (繼承來源 ComboBox) |
| SelectedItem |
取得或設定目前在 ComboBox 中選取的項目。 (繼承來源 ComboBox) |
| SelectedText |
取得或設定在 ComboBox 的可編輯部分中選取的文字。 (繼承來源 ComboBox) |
| SelectedValue |
取得或設定 ValueMember 屬性指定的成員屬性值。 (繼承來源 ListControl) |
| SelectionLength |
取得或設定在下拉式方塊可編輯部分中選取的字元數。 (繼承來源 ComboBox) |
| SelectionStart |
取得或設定下拉式方塊中所選取文字的起始索引。 (繼承來源 ComboBox) |
| ShowFocusCues |
取得指示控制項是否應顯示焦點矩形 (Focus Rectangle) 的值。 (繼承來源 Control) |
| ShowKeyboardCues |
取得值，指出使用者介面是否處於可顯示或隱藏鍵盤快速鍵的適當狀態下。 (繼承來源 Control) |
| Site |
取得或設定控制項的站台。 (繼承來源 Control) |
| Size |
取得或設定控制項的高度和寬度。 (繼承來源 Control) |
| Sorted |
取得或設定值，指出是否排序下拉式方塊中的項目。 (繼承來源 ComboBox) |
| TabIndex |
取得或設定控制項容器中的控制項定位順序。 (繼承來源 Control) |
| TabStop |
取得或設定值，指出使用者是否能使用 TAB 鍵，將焦點 (Focus) 給予這個控制項。 (繼承來源 Control) |
| Tag |
取得或設定物件，其包含控制項相關資料。 (繼承來源 Control) |
| Text |
取得或設定這個控制項的相關文字。 (繼承來源 ComboBox) |
| Top |
取得或設定控制項上邊緣和其容器工作區 (Client Area) 上邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
| TopLevelControl |
取得沒有其他 Windows Form 父控制項的父控制項。 通常，這會是內含控制項最外層的 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) |
