DataGridViewComboBoxCell Class
TOC
Collapse the table of content
Expand the table of content

DataGridViewComboBoxCell Class

 

Displays a combo box in a DataGridView control.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

System.Object
  System.Windows.Forms.DataGridViewElement
    System.Windows.Forms.DataGridViewCell
      System.Windows.Forms.DataGridViewComboBoxCell

public class DataGridViewComboBoxCell : DataGridViewCell

NameDescription
System_CAPS_pubmethodDataGridViewComboBoxCell()

Initializes a new instance of the DataGridViewComboBoxCell class.

NameDescription
System_CAPS_pubpropertyAccessibilityObject
System_CAPS_pubpropertyAutoComplete

Gets or sets a value indicating whether the cell will match the characters being entered in the cell with a selection from the drop-down list.

System_CAPS_pubpropertyColumnIndex

Gets the column index for this cell. (Inherited from DataGridViewCell.)

System_CAPS_pubpropertyContentBounds

Gets the bounding rectangle that encloses the cell's content area.(Inherited from DataGridViewCell.)

System_CAPS_pubpropertyContextMenuStrip

Gets or sets the shortcut menu associated with the cell. (Inherited from DataGridViewCell.)

System_CAPS_pubpropertyDataGridView

Gets the DataGridView control associated with this element.(Inherited from DataGridViewElement.)

System_CAPS_pubpropertyDataSource

Gets or sets the data source whose data contains the possible selections shown in the drop-down list.

System_CAPS_pubpropertyDefaultNewRowValue

Gets the default value for a cell in the row for new records.(Inherited from DataGridViewCell.)

System_CAPS_pubpropertyDisplayed

Gets a value that indicates whether the cell is currently displayed on-screen. (Inherited from DataGridViewCell.)

System_CAPS_pubpropertyDisplayMember

Gets or sets a string that specifies where to gather selections to display in the drop-down list.

System_CAPS_pubpropertyDisplayStyle

Gets or sets a value that determines how the combo box is displayed when it is not in edit mode.

System_CAPS_pubpropertyDisplayStyleForCurrentCellOnly

Gets or sets a value indicating whether the DisplayStyle property value applies to the cell only when it is the current cell in the DataGridView control.

System_CAPS_pubpropertyDropDownWidth

Gets or sets the width of the of the drop-down list portion of a combo box.

System_CAPS_pubpropertyEditedFormattedValue

Gets the current, formatted value of the cell, regardless of whether the cell is in edit mode and the value has not been committed. (Inherited from DataGridViewCell.)

System_CAPS_pubpropertyEditType

Gets the type of the cell's hosted editing control.(Overrides DataGridViewCell.EditType.)

System_CAPS_pubpropertyErrorIconBounds

Gets the bounds of the error icon for the cell.(Inherited from DataGridViewCell.)

System_CAPS_pubpropertyErrorText

Gets or sets the text describing an error condition associated with the cell. (Inherited from DataGridViewCell.)

System_CAPS_pubpropertyFlatStyle

Gets or sets the flat style appearance of the cell.

System_CAPS_pubpropertyFormattedValue

Gets the value of the cell as formatted for display.(Inherited from DataGridViewCell.)

System_CAPS_pubpropertyFormattedValueType

Gets the class type of the formatted value associated with the cell.(Overrides DataGridViewCell.FormattedValueType.)

System_CAPS_pubpropertyFrozen

Gets a value indicating whether the cell is frozen. (Inherited from DataGridViewCell.)

System_CAPS_pubpropertyHasStyle

Gets a value indicating whether the Style property has been set.(Inherited from DataGridViewCell.)

System_CAPS_pubpropertyInheritedState

Gets the current state of the cell as inherited from the state of its row and column.(Inherited from DataGridViewCell.)

System_CAPS_pubpropertyInheritedStyle

Gets the style currently applied to the cell. (Inherited from DataGridViewCell.)

System_CAPS_pubpropertyIsInEditMode

Gets a value indicating whether this cell is currently being edited.(Inherited from DataGridViewCell.)

System_CAPS_pubpropertyItems

Gets the objects that represent the selection displayed in the drop-down list.

System_CAPS_pubpropertyMaxDropDownItems

Gets or sets the maximum number of items shown in the drop-down list.

System_CAPS_pubpropertyOwningColumn

Gets the column that contains this cell.(Inherited from DataGridViewCell.)

System_CAPS_pubpropertyOwningRow

Gets the row that contains this cell. (Inherited from DataGridViewCell.)

System_CAPS_pubpropertyPreferredSize

Gets the size, in pixels, of a rectangular area into which the cell can fit. (Inherited from DataGridViewCell.)

System_CAPS_pubpropertyReadOnly

Gets or sets a value indicating whether the cell's data can be edited. (Inherited from DataGridViewCell.)

System_CAPS_pubpropertyResizable

Gets a value indicating whether the cell can be resized. (Inherited from DataGridViewCell.)

System_CAPS_pubpropertyRowIndex

Gets the index of the cell's parent row. (Inherited from DataGridViewCell.)

System_CAPS_pubpropertySelected

Gets or sets a value indicating whether the cell has been selected. (Inherited from DataGridViewCell.)

System_CAPS_pubpropertySize

Gets the size of the cell.(Inherited from DataGridViewCell.)

System_CAPS_pubpropertySorted

Gets or sets a value indicating whether the items in the combo box are automatically sorted.

System_CAPS_pubpropertyState

Gets the user interface (UI) state of the element.(Inherited from DataGridViewElement.)

System_CAPS_pubpropertyStyle

Gets or sets the style for the cell. (Inherited from DataGridViewCell.)

System_CAPS_pubpropertyTag

Gets or sets the object that contains supplemental data about the cell. (Inherited from DataGridViewCell.)

System_CAPS_pubpropertyToolTipText

Gets or sets the ToolTip text associated with this cell.(Inherited from DataGridViewCell.)

System_CAPS_pubpropertyValue

Gets or sets the value associated with this cell. (Inherited from DataGridViewCell.)

System_CAPS_pubpropertyValueMember

Gets or sets a string that specifies where to gather the underlying values used in the drop-down list.

System_CAPS_pubpropertyValueType

Gets or sets the data type of the values in the cell. (Overrides DataGridViewCell.ValueType.)

System_CAPS_pubpropertyVisible

Gets a value indicating whether the cell is in a row or column that has been hidden. (Inherited from DataGridViewCell.)

NameDescription
System_CAPS_pubmethodAdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)

Modifies the input cell border style according to the specified criteria. (Inherited from DataGridViewCell.)

System_CAPS_protmethodBorderWidths(DataGridViewAdvancedBorderStyle)

Returns a Rectangle that represents the widths of all the cell margins. (Inherited from DataGridViewCell.)

System_CAPS_protmethodClickUnsharesRow(DataGridViewCellEventArgs)

Indicates whether the cell's row will be unshared when the cell is clicked.(Inherited from DataGridViewCell.)

System_CAPS_pubmethodClone()

Creates an exact copy of this cell.(Overrides DataGridViewCell.Clone().)

System_CAPS_protmethodContentClickUnsharesRow(DataGridViewCellEventArgs)

Indicates whether the cell's row will be unshared when the cell's content is clicked.(Inherited from DataGridViewCell.)

System_CAPS_protmethodContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)

Indicates whether the cell's row will be unshared when the cell's content is double-clicked.(Inherited from DataGridViewCell.)

System_CAPS_protmethodCreateAccessibilityInstance()

Creates a new accessible object for the DataGridViewCell. (Inherited from DataGridViewCell.)

System_CAPS_pubmethodDetachEditingControl()

Removes the cell's editing control from the DataGridView.(Overrides DataGridViewCell.DetachEditingControl().)

System_CAPS_pubmethodDispose()

Releases all resources used by the DataGridViewCell. (Inherited from DataGridViewCell.)

System_CAPS_protmethodDispose(Boolean)

Releases the unmanaged resources used by the DataGridViewCell and optionally releases the managed resources. (Inherited from DataGridViewCell.)

System_CAPS_protmethodDoubleClickUnsharesRow(DataGridViewCellEventArgs)

Indicates whether the cell's row will be unshared when the cell is double-clicked.(Inherited from DataGridViewCell.)

System_CAPS_protmethodEnterUnsharesRow(Int32, Boolean)

Indicates whether the parent row will be unshared when the focus moves to the cell.(Inherited from DataGridViewCell.)

System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Releases the unmanaged resources and performs other cleanup operations before the DataGridViewCell is reclaimed by garbage collection.(Inherited from DataGridViewCell.)

System_CAPS_protmethodGetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)

Retrieves the formatted value of the cell to copy to the Clipboard.(Inherited from DataGridViewCell.)

System_CAPS_protmethodGetContentBounds(Graphics, DataGridViewCellStyle, Int32)

Returns the bounding rectangle that encloses the cell's content area, which is calculated using the specified Graphics and cell style.(Overrides DataGridViewCell.GetContentBounds(Graphics, DataGridViewCellStyle, Int32).)

System_CAPS_pubmethodGetContentBounds(Int32)

Returns the bounding rectangle that encloses the cell's content area using a default Graphics and cell style currently in effect for the cell.(Inherited from DataGridViewCell.)

System_CAPS_pubmethodGetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)

Returns the current, formatted value of the cell, regardless of whether the cell is in edit mode and the value has not been committed.(Inherited from DataGridViewCell.)

System_CAPS_protmethodGetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)

Returns the bounding rectangle that encloses the cell's error icon, if one is displayed.(Overrides DataGridViewCell.GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32).)

System_CAPS_protmethodGetErrorText(Int32)

Returns a string that represents the error for the cell.(Inherited from DataGridViewCell.)

System_CAPS_protmethodGetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)
System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetInheritedContextMenuStrip(Int32)

Gets the inherited shortcut menu for the current cell.(Inherited from DataGridViewCell.)

System_CAPS_pubmethodGetInheritedState(Int32)

Returns a value indicating the current state of the cell as inherited from the state of its row and column.(Inherited from DataGridViewCell.)

System_CAPS_pubmethodGetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)

Gets the style applied to the cell. (Inherited from DataGridViewCell.)

System_CAPS_protmethodGetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)

Calculates the preferred size, in pixels, of the cell.(Overrides DataGridViewCell.GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size).)

System_CAPS_protmethodGetSize(Int32)

Gets the size of the cell.(Inherited from DataGridViewCell.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_protmethodGetValue(Int32)

Gets the value of the cell. (Inherited from DataGridViewCell.)

System_CAPS_pubmethodInitializeEditingControl(Int32, Object, DataGridViewCellStyle)

Attaches and initializes the hosted editing control.(Overrides DataGridViewCell.InitializeEditingControl(Int32, Object, DataGridViewCellStyle).)

System_CAPS_protmethodKeyDownUnsharesRow(KeyEventArgs, Int32)

Indicates whether the parent row is unshared if the user presses a key while the focus is on the cell.(Inherited from DataGridViewCell.)

System_CAPS_pubmethodKeyEntersEditMode(KeyEventArgs)

Determines if edit mode should be started based on the given key.(Overrides DataGridViewCell.KeyEntersEditMode(KeyEventArgs).)

System_CAPS_protmethodKeyPressUnsharesRow(KeyPressEventArgs, Int32)

Indicates whether a row will be unshared if a key is pressed while a cell in the row has focus.(Inherited from DataGridViewCell.)

System_CAPS_protmethodKeyUpUnsharesRow(KeyEventArgs, Int32)

Indicates whether the parent row is unshared when the user releases a key while the focus is on the cell.(Inherited from DataGridViewCell.)

System_CAPS_protmethodLeaveUnsharesRow(Int32, Boolean)

Indicates whether a row will be unshared when the focus leaves a cell in the row.(Inherited from DataGridViewCell.)

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_protmethodMouseClickUnsharesRow(DataGridViewCellMouseEventArgs)

Indicates whether a row will be unshared if the user clicks a mouse button while the pointer is on a cell in the row.(Inherited from DataGridViewCell.)

System_CAPS_protmethodMouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)

Indicates whether a row will be unshared if the user double-clicks a cell in the row.(Inherited from DataGridViewCell.)

System_CAPS_protmethodMouseDownUnsharesRow(DataGridViewCellMouseEventArgs)

Indicates whether a row will be unshared when the user holds down a mouse button while the pointer is on a cell in the row.(Inherited from DataGridViewCell.)

System_CAPS_protmethodMouseEnterUnsharesRow(Int32)

Indicates whether a row will be unshared when the mouse pointer moves over a cell in the row.(Inherited from DataGridViewCell.)

System_CAPS_protmethodMouseLeaveUnsharesRow(Int32)

Indicates whether a row will be unshared when the mouse pointer leaves the row.(Inherited from DataGridViewCell.)

System_CAPS_protmethodMouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)

Indicates whether a row will be unshared when the mouse pointer moves over a cell in the row.(Inherited from DataGridViewCell.)

System_CAPS_protmethodMouseUpUnsharesRow(DataGridViewCellMouseEventArgs)

Indicates whether a row will be unshared when the user releases a mouse button while the pointer is on a cell in the row.(Inherited from DataGridViewCell.)

System_CAPS_protmethodOnClick(DataGridViewCellEventArgs)

Called when the cell is clicked.(Inherited from DataGridViewCell.)

System_CAPS_protmethodOnContentClick(DataGridViewCellEventArgs)

Called when the cell's contents are clicked.(Inherited from DataGridViewCell.)

System_CAPS_protmethodOnContentDoubleClick(DataGridViewCellEventArgs)

Called when the cell's contents are double-clicked.(Inherited from DataGridViewCell.)

System_CAPS_protmethodOnDataGridViewChanged()

Called when the DataGridView property of the cell changes.(Overrides DataGridViewCell.OnDataGridViewChanged().)

System_CAPS_protmethodOnDoubleClick(DataGridViewCellEventArgs)

Called when the cell is double-clicked.(Inherited from DataGridViewCell.)

System_CAPS_protmethodOnEnter(Int32, Boolean)

Called when the focus moves to a cell.(Overrides DataGridViewCell.OnEnter(Int32, Boolean).)

System_CAPS_protmethodOnKeyDown(KeyEventArgs, Int32)

Called when a character key is pressed while the focus is on a cell.(Inherited from DataGridViewCell.)

System_CAPS_protmethodOnKeyPress(KeyPressEventArgs, Int32)

Called when a key is pressed while the focus is on a cell.(Inherited from DataGridViewCell.)

System_CAPS_protmethodOnKeyUp(KeyEventArgs, Int32)

Called when a character key is released while the focus is on a cell.(Inherited from DataGridViewCell.)

System_CAPS_protmethodOnLeave(Int32, Boolean)

Called when the focus moves from a cell.(Overrides DataGridViewCell.OnLeave(Int32, Boolean).)

System_CAPS_protmethodOnMouseClick(DataGridViewCellMouseEventArgs)

Called when the user clicks a mouse button while the pointer is on a cell.(Overrides DataGridViewCell.OnMouseClick(DataGridViewCellMouseEventArgs).)

System_CAPS_protmethodOnMouseDoubleClick(DataGridViewCellMouseEventArgs)

Called when the user double-clicks a mouse button while the pointer is on a cell.(Inherited from DataGridViewCell.)

System_CAPS_protmethodOnMouseDown(DataGridViewCellMouseEventArgs)

Called when the user holds down a mouse button while the pointer is on a cell.(Inherited from DataGridViewCell.)

System_CAPS_protmethodOnMouseEnter(Int32)

Called when the mouse pointer moves over a cell.(Overrides DataGridViewCell.OnMouseEnter(Int32).)

System_CAPS_protmethodOnMouseLeave(Int32)

Called when the mouse pointer leaves the cell.(Overrides DataGridViewCell.OnMouseLeave(Int32).)

System_CAPS_protmethodOnMouseMove(DataGridViewCellMouseEventArgs)

Called when the mouse pointer moves within a cell.(Overrides DataGridViewCell.OnMouseMove(DataGridViewCellMouseEventArgs).)

System_CAPS_protmethodOnMouseUp(DataGridViewCellMouseEventArgs)

Called when the user releases a mouse button while the pointer is on a cell. (Inherited from DataGridViewCell.)

System_CAPS_protmethodPaint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)
System_CAPS_protmethodPaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)

Paints the border of the current DataGridViewCell.(Inherited from DataGridViewCell.)

System_CAPS_protmethodPaintErrorIcon(Graphics, Rectangle, Rectangle, String)

Paints the error icon of the current DataGridViewCell.(Inherited from DataGridViewCell.)

System_CAPS_pubmethodParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)

Converts a value formatted for display to an actual cell value.(Overrides DataGridViewCell.ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter).)

System_CAPS_pubmethodPositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)

Sets the location and size of the editing control hosted by a cell in the DataGridView control. (Inherited from DataGridViewCell.)

System_CAPS_pubmethodPositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)

Sets the location and size of the editing panel hosted by the cell, and returns the normal bounds of the editing control within the editing panel.(Inherited from DataGridViewCell.)

System_CAPS_protmethodRaiseCellClick(DataGridViewCellEventArgs)

Raises the DataGridView.CellClick event. (Inherited from DataGridViewElement.)

System_CAPS_protmethodRaiseCellContentClick(DataGridViewCellEventArgs)

Raises the DataGridView.CellContentClick event. (Inherited from DataGridViewElement.)

System_CAPS_protmethodRaiseCellContentDoubleClick(DataGridViewCellEventArgs)

Raises the DataGridView.CellContentDoubleClick event. (Inherited from DataGridViewElement.)

System_CAPS_protmethodRaiseCellValueChanged(DataGridViewCellEventArgs)

Raises the DataGridView.CellValueChanged event. (Inherited from DataGridViewElement.)

System_CAPS_protmethodRaiseDataError(DataGridViewDataErrorEventArgs)

Raises the DataGridView.DataError event. (Inherited from DataGridViewElement.)

System_CAPS_protmethodRaiseMouseWheel(MouseEventArgs)

Raises the Control.MouseWheel event. (Inherited from DataGridViewElement.)

System_CAPS_protmethodSetValue(Int32, Object)

Sets the value of the cell. (Inherited from DataGridViewCell.)

System_CAPS_pubmethodToString()

Returns a string that describes the current object. (Overrides DataGridViewCell.ToString().)

The DataGridViewComboBoxCell class is a specialized type of DataGridViewCell used to display a combo box control, which is an editing field combined with a list selection field. The currently selected DataGridViewComboBoxCell hosts a DataGridViewComboBoxEditingControl in which the user can change the cell's value, assuming the cell's ReadOnly property is set to false.

Unlike the ComboBox control, the DataGridViewComboBoxCell does not have SelectedIndex and SelectedValue properties. Instead, selecting a value from a drop-down list sets the cell Value property.

The DataGridViewComboBoxColumn is the column type specialized to hold cells of this type. By default, the DataGridViewComboBoxColumn.CellTemplate is initialized to a new DataGridViewComboBoxCell. To pattern the cells within a column after an existing DataGridViewComboBoxCell, set the column's CellTemplate property to the cell to use as a pattern.

The cell-related properties of the column are wrappers for the similarly-named properties of the template cell. Changing the property values of the template cell will affect only cells based on the template that are added after the change. Changing the cell-related property values of the column, however, will update the template cell and all other cells in the column, and refresh the column display if necessary.

You will typically work with the DataGridViewComboBoxColumn type unless you want to override column values for specific cells. The guidelines described in the DataGridViewComboBoxColumn class overview topic for populating the drop-down list applies to both cell and column instances.

Notes to Inheritors:

When you derive from DataGridViewComboBoxCell and add new properties to the derived class, be sure to override the Clone method to copy the new properties during cloning operations. You should also call the base class's Clone method so that the properties of the base class are copied to the new cell.

The following code example demonstrates the DataGridViewComboBoxColumn class, which makes use of the DataGridViewComboBoxCell class. You can set the cell DataSource, ValueMember, and DisplayMember properties in the same way that the corresponding column properties are set in this example. This example is part of a larger example available in the DataGridViewComboBoxColumn class overview topic.

private DataGridViewComboBoxColumn CreateComboBoxColumn()
{
    DataGridViewComboBoxColumn column =
        new DataGridViewComboBoxColumn();
    {
        column.DataPropertyName = ColumnName.TitleOfCourtesy.ToString();
        column.HeaderText = ColumnName.TitleOfCourtesy.ToString();
        column.DropDownWidth = 160;
        column.Width = 90;
        column.MaxDropDownItems = 3;
        column.FlatStyle = FlatStyle.Flat;
    }
    return column;
}

private void SetAlternateChoicesUsingDataSource(DataGridViewComboBoxColumn comboboxColumn)
{
    {
        comboboxColumn.DataSource = RetrieveAlternativeTitles();
        comboboxColumn.ValueMember = ColumnName.TitleOfCourtesy.ToString();
        comboboxColumn.DisplayMember = comboboxColumn.ValueMember;
    }
}

private DataTable RetrieveAlternativeTitles()
{
    return Populate("SELECT distinct TitleOfCourtesy FROM Employees");
}

string connectionString =
    "Integrated Security=SSPI;Persist Security Info=False;" +
    "Initial Catalog=Northwind;Data Source=localhost";

private DataTable Populate(string sqlCommand)
{
    SqlConnection northwindConnection = new SqlConnection(connectionString);
    northwindConnection.Open();

    SqlCommand command = new SqlCommand(sqlCommand, northwindConnection);
    SqlDataAdapter adapter = new SqlDataAdapter();
    adapter.SelectCommand = command;

    DataTable table = new DataTable();
    table.Locale = System.Globalization.CultureInfo.InvariantCulture;
    adapter.Fill(table);

    return table;
}

// Using an enum provides some abstraction between column index
// and column name along with compile time checking, and gives
// a handy place to store the column names.
enum ColumnName
{
    EmployeeId,
    LastName,
    FirstName,
    Title,
    TitleOfCourtesy,
    BirthDate,
    HireDate,
    Address,
    City,
    Region,
    PostalCode,
    Country,
    HomePhone,
    Extension,
    Photo,
    Notes,
    ReportsTo,
    PhotoPath,
    OutOfOffice
};

.NET Framework
Available since 2.0

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show:
© 2016 Microsoft