DataGridViewComboBoxCell.MaxDropDownItems Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

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

public virtual int MaxDropDownItems { get; set; }

Property Value

Type: System.Int32

The number of drop-down list items to allow. The minimum is 1 and the maximum is 100; the default is 8.

Exception Condition
ArgumentOutOfRangeException

The value is less than 1 or greater than 100 when setting this property.

Changing the MaxDropDownItems property changes the corresponding MaxDropDownItems property of the hosted DataGridViewComboBoxEditingControl, if one exits.

The following code example demonstrates the use of the DataGridViewComboBoxColumn.MaxDropDownItems property, which is similar to this property. This example is part of a larger example available in the DataGridViewComboBoxColumn class overview topic.

private static void SetAlternateChoicesUsingItems(
    DataGridViewComboBoxColumn comboboxColumn)
{
    comboboxColumn.Items.AddRange("Mr.", "Ms.", "Mrs.", "Dr.");
}

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;
}

.NET Framework
Available since 2.0
Return to top
Show: