DataGridViewComboBoxColumn

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.1.0.0)

• DataGridViewElement
  • DataGridViewBand
    • DataGridViewColumn
      • DataGridViewComboBoxColumn

Represents a DataGridView column that contains a collection of DataGridViewComboBoxCell cells.

C#

public class DataGridViewComboBoxColumn : DataGridViewColumn

VB.NET

Public Class DataGridViewComboBoxColumn
    Inherits DataGridViewColumn

Constructors

DataGridViewComboBoxColumn()

Initializes a new instance of the DataGridViewComboBoxColumn class to the default state.

DataGridViewComboBoxColumn(cellTemplate)

Initializes a new instance of the DataGridViewComboBoxColumn class to the default state.

Name	Type	Description
cellTemplate	DataGridViewComboBoxCell	An existing DataGridViewButtonCell to use as a template.

Properties

AutoCompleteMode

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

Value: One of the values of AutoCompleteMode. The default is None.

CellTemplate

DataGridViewCell: Returns or sets the template used to model cell appearance.

Value: A DataGridViewCell that all other cells in the column are modeled after.

Throws:

• InvalidOperationException The type is null.
• InvalidCastException The set type is not compatible with type DataGridViewComboBoxCell.

CharacterCasing

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

Value: One of the CharacterCasing enumeration values. The default is CharacterCasing.Normal.

DataSource

Object: Returns or sets the data source that populates the selections for the combo boxes. (Default: null)

Value: An object that represents a data source. The default is null.

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: "")

Value: A String that specifies the name of a property or column in the data source specified in the DataSource property. The default is Empty.

DropDownStyle

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

Value: One of the ComboBoxStyle values. The default is DropDown.

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: "")

Value: A String that specifies the name of a property or column to use in the DataSource property. The default is Empty.

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 DataGridViewComboBoxColumn.

Value: A ObjectCollection containing the items in the DataGridViewComboBoxColumn.

Throws:

• InvalidOperationException The value of the CellTemplate property is null.

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)

Value: The maximum number of characters that can be entered into the text box; the default value is 0 (unlimited).

Throws:

• InvalidOperationException The value of the CellTemplate property is null.

Sorted

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

Value: true if the combo box is sorted; otherwise, false. The default is 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 control.

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: "")

Value: A String that specifies the name of a property or column to use in the DataSource property. The default is Empty.

ValueType

Type: Returns or sets the data type of the values in the column's cells.

Value: A Type representing the data type of the value in the column's cells.

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 textbox is empty. (Default: null)

Methods

OnDataGridViewChanged()

Called when the element is associated with a different DataGridView.

Implements

Name	Description
IUserData	Provides access to the UserData and Tag properties associated to the component implementing this interface.
IWisejComponent	All wisej components implement this interface.
IWisejSerializable	Allows an object to serialize itself.