Xceed Grid for WinForms v4.3 Documentation
AllowFreeText Property


Xceed.Grid.v4.3 Assembly > Xceed.Editors Namespace > WinComboBox Class : AllowFreeText Property
Gets or sets a value indicating if text other than combobox values can be entered into the combobox.
Syntax
'Declaration
 
<DescriptionAttribute("Indicates if text other than combobox values can be entered into the combobox.")>
<CategoryAttribute("Behavior")>
Public Property AllowFreeText As Boolean
'Usage
 
Dim instance As WinComboBox
Dim value As Boolean
 
instance.AllowFreeText = value
 
value = instance.AllowFreeText
[Description("Indicates if text other than combobox values can be entered into the combobox.")]
[Category("Behavior")]
public bool AllowFreeText {get; set;}

Property Value

true if text other than combobox values can be entered into the combobox; false otherwise. If false combobox items will be selected when typing the first characters of the item.
Remarks

The dropdown style of the WinCombBox control is determined by the AllowFreeText property. If AllowFreeText is set to true (default), any text can be written into the WinComboBox, however pressing the Enter or TAB key will not select an item in the dropdown. This is the equivalent of setting the DropDownStyle property of the Windows Forms ComboBox control to DropDown.

If AllowFreeText is set to false, only the first letter of the items located in the dropdown can be entered into the combobox. For example, pressing "S" will select the first item in the dropdown that has an uppercase "S" as its first letter. If no items begin with a uppercase "S", the current item will remain the selected item. If an item begins with a lowercase "s", it will not be selected in an uppercase "S" is entered. This is the equivalent of setting the DropDownStyle property of the Windows Forms ComboBox control to DropDownList.

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

See Also

Reference

WinComboBox Class
WinComboBox Members