DataGridViewComboBoxCell.MaxDropDownItems Property


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

 virtual property int MaxDropDownItems { int get(); void set(int value); };
public virtual int MaxDropDownItems { get; set; }
member this.MaxDropDownItems : int with get, set
Public Overridable Property MaxDropDownItems As Integer

Property Value

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


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


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.

    void SetAlternateChoicesUsingItems(
        DataGridViewComboBoxColumn^ comboboxColumn)
        comboboxColumn->Items->AddRange("Mr.", "Ms.", "Mrs.", "Dr.");

    DataGridViewComboBoxColumn^ CreateComboBoxColumn()
        DataGridViewComboBoxColumn^ column =
            gcnew 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 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;
Private Shared Sub SetAlternateChoicesUsingItems( _
    ByVal comboboxColumn As DataGridViewComboBoxColumn)

    comboboxColumn.Items.AddRange("Mr.", "Ms.", "Mrs.", "Dr.")

End Sub

Private Function CreateComboBoxColumn() _
    As DataGridViewComboBoxColumn
    Dim column As New DataGridViewComboBoxColumn()

    With column
        .DataPropertyName = ColumnName.TitleOfCourtesy.ToString()
        .HeaderText = ColumnName.TitleOfCourtesy.ToString()
        .DropDownWidth = 160
        .Width = 90
        .MaxDropDownItems = 3
        .FlatStyle = FlatStyle.Flat
    End With
    Return column
End Function


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

Applies to

See also