DataGridViewComboBoxCell

Namespace: Wisej.Web

Assembly: Wisej.Framework (3.5.0.0)

• DataGridViewElement
  • DataGridViewCell
    • DataGridViewComboBoxCell

Displays an editable ComboBox control in a DataGridViewCell cell when in edit mode.

C#

public class DataGridViewComboBoxCell : DataGridViewCell

VB.NET

Public Class DataGridViewComboBoxCell
    Inherits DataGridViewCell

Constructors

DataGridViewComboBoxCell()

Initializes a new instance of DataGridViewComboBoxCell.

Properties

AutoCompleteMode

AutoCompleteMode: Returns or sets how automatic completion works for the DataGridViewComboBoxColumn. (Default: None)

CharacterCasing

CharacterCasing: Returns or sets whether the cell editor modifies the case of characters as they are typed. (Default: Normal)

DataSource

Object: Returns or sets the data source that contains the possible selections shown in the drop-down list.

Throws:

• ArgumentException The specified value when setting this property is not null and is not of type IList nor IListSource.

DisplayMember

String: Returns or sets the name of the property or column from which to retrieve the text to display in the combo box cell. (Default: "")

Throws:

• ArgumentException The DataSource property is not null and the specified value when setting this property is not null or Empty and does not name a valid property or column in the data source.

DropDownStyle

ComboBoxStyle: Returns or sets the style of the combo box. (Default: DropDown)

EditType

Type: Returns the type of the cell's hosted editing control.

IconMember

String: Returns or sets the name of the property or column from which to get the icon to use in the drop-down list. (Default: "")

Throws:

• ArgumentException The DataSource property is not null and the specified value when setting this property is not null or Empty and does not name a valid property or column in the data source.

IncrementalSelection

Boolean: Returns or sets whether items are selected incrementally as the user types within a timeout of 1 second. (Default: True)

Items

ObjectCollection: Returns the collection of the items contained in this DataGridViewComboBoxCell.

LazyLoading

Boolean: Enables or disables lazy loading mode for the ComboBox cell editor control. (Default: False)

MaxInputLength

Int32: Returns or sets the maximum number of characters that can be entered into the editable part of the combo box control. (Default: 0)

Throws:

• ArgumentOutOfRangeException The value is less than 0.

Sorted

Boolean: Returns or sets if the items in the combo box editor are automatically sorted. (Default: False)

Throws:

• ArgumentException An attempt was made to sort a cell that is attached to a data source.

Tools

ComponentToolCollection: Returns the instance of ComponentToolCollection associated with this cell.

ValueMember

String: Returns or sets the name of the property or column from which to get the value that correspond to the selections in the drop-down list. (Default: "")

Throws:

• ArgumentException The DataSource property is not null and the specified value when setting this property is not null or Empty and does not name a valid property or column in the data source.

ValueType

Type: Returns or sets the data type of the values in the cell.

VirtualScroll

Boolean: Enables or disables virtual scrolling mode for the ComboBox cell editor control. (Default: False)

Watermark

String: Returns or sets the text to show when the control is empty.

Methods

ParseFormattedValue(value, cellStyle, formattedTypeConverter, valueTypeConverter)

Converts a value to the actual cell value.

Parameter	Type	Description
value	Object	The display value of the cell.
cellStyle	DataGridViewCellStyle	The DataGridViewCellStyle in effect for the cell.
formattedTypeConverter	TypeConverter	A TypeConverter for the display value type, or null to use the default converter.
valueTypeConverter	TypeConverter	A TypeConverter for the cell value type, or null to use the default converter.

Returns: Object. The cell value.

Throws:

• ArgumentNullException cellStyle is null.
• FormatException The FormattedValueType property value is null or the ValueType property value is null or value cannot be converted.
• ArgumentException value is null or the type of value does not match the type indicated by the FormattedValueType property.

Events

ItemsCollectionChanged

EventHandler Fired when the collection changes.

Implements

Name	Description
ICommandSource	Defines an object that can invoke a Command.