MaxLength Property (ComboBoxCell)

Gets or sets the maximum number of characters possible in the editable portion of a combo box.

Syntax

Visual Basic (Declaration)
Visual Basic (Usage)
C#

<SRDescriptionAttribute("Indicates the maximum number of characters that can be entered into the ComboBoxCell.")>
<LocalizableAttribute(True)>
<DefaultValueAttribute()>
<SRCategoryAttribute("Behavior")>
Public Property MaxLength As Integer

Dim instance As ComboBoxCell
Dim value As Integer
 
instance.MaxLength = value
 
value = instance.MaxLength

[SRDescription("Indicates the maximum number of characters that can be entered into the ComboBoxCell.")]
[Localizable(true)]
[DefaultValue()]
[SRCategory("Behavior")]
public int MaxLength {get; set;}

Property Value

A System.Int32 value that represents the maximum number of characters the user can enter. The default is 0.

Remarks

If set to a value less than zero, the property value is reset to zero, which is the default value.

The default value 0 means there is no restriction on the MaxLength.

This property only takes effect when DropDownStyle is MultiRowComboBoxStyle.DropDown. If the length of the item value is more than the MaxLength property, the user can still select the value.

Example

This example creates a combo box cell.

GrapeCity.Win.MultiRow.TextBoxCell text1 = new GrapeCity.Win.MultiRow.TextBoxCell();
GrapeCity.Win.MultiRow.ComboBoxCell combo2 = new GrapeCity.Win.MultiRow.ComboBoxCell();
combo2.Items.AddRange("Item2", "Item1", "Item3", "Item4");
combo2.FlatStyle = FlatStyle.Flat;
combo2.HighlightText = true;
combo2.MaxDropDownItems = 3;
combo2.DropDownStyle = GrapeCity.Win.MultiRow.MultiRowComboBoxStyle.DropDown;
combo2.MaxLength = 4;
GrapeCity.Win.MultiRow.Template template1 = GrapeCity.Win.MultiRow.Template.CreateGridTemplate(new GrapeCity.Win.MultiRow.Cell[] { text1, combo2 }, 160, GrapeCity.Win.MultiRow.AutoGenerateGridTemplateStyles.ColumnHeader | GrapeCity.Win.MultiRow.AutoGenerateGridTemplateStyles.RowHeaderAutoNumber);
template1.ColumnHeaders[0].Cells[0].Value = "Column1";
template1.ColumnHeaders[0].Cells[1].Value = "Column2";
gcMultiRow1.Template = template1;
gcMultiRow1.RowCount = 3;

VB.NET

Dim text1 As New GrapeCity.Win.MultiRow.TextBoxCell()
Dim combo2 As New GrapeCity.Win.MultiRow.ComboBoxCell()
combo2.Items.AddRange("Item2", "Item1", "Item3", "Item4")
combo2.FlatStyle = FlatStyle.Flat
combo2.HighlightText = True
combo2.MaxDropDownItems = 3
combo2.DropDownStyle = GrapeCity.Win.MultiRow.MultiRowComboBoxStyle.DropDown
combo2.MaxLength = 4
Dim template1 As GrapeCity.Win.MultiRow.Template = GrapeCity.Win.MultiRow.Template.CreateGridTemplate(New GrapeCity.Win.MultiRow.Cell() {text1, combo2}, 160, GrapeCity.Win.MultiRow.AutoGenerateGridTemplateStyles.ColumnHeader Or GrapeCity.Win.MultiRow.AutoGenerateGridTemplateStyles.RowHeaderAutoNumber)
template1.ColumnHeaders(0).Cells(0).Value = "Column1"
template1.ColumnHeaders(0).Cells(1).Value = "Column2"
GcMultiRow1.Template = template1
GcMultiRow1.RowCount = 3

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

ComboBoxCell Class
ComboBoxCell Members