Infragistics(R) NetAdvantage(R) Windows Forms
AutoCompleteMode Property
See Also  E-mail your feedback on this topic.
Infragistics.Win.UltraWinGrid Namespace > UltraGridColumn Class : AutoCompleteMode Property

Gets/sets the mode for automatic completion of text typed in the edit portion.

Syntax

Visual Basic (Declaration) 
Public Property AutoCompleteMode As Infragistics.Win.AutoCompleteMode
C# 
public Infragistics.Win.AutoCompleteMode AutoCompleteMode {get; set;}

Remarks

Note: This property replaces the AutoEdit property, which is now obsolete. Setting the AutoCompleteMode property to 'Append' is the functional equivalent of setting AutoEdit to true.

Prior to the addition of the AutoCompleteMode property, automatic value completion was supported in the form of the now obsolete AutoComplete property, which, when enabled, modified the control's text by appending characters to the string typed by the end user so as to match the text of the first item found in the list whose text begins with the typed characters. For example, given a list which contains an item whose text is "Apple", when the end user types the string "Ap", the edit portion would then be updated to include the remaining characters, "ple", so that the text of the first item that matches the typed string, "Apple", becomes selected. That same functionality is now enabled by setting AutoCompleteMode to 'Append'. The appended characters are selected so that continuing to type causes these characters to be removed.

The AutoCompleteMode property extends two additional modes for value completion, 'Suggest' and 'SuggestAppend'. When the property is set to 'Suggest', no characters are appended to the edit portion, but rather the dropdown is automatically displayed, showing only the items whose text begins with the string that was typed by the end user. For example, given a list containing the items, "Apple", "Application", and "Apprehend", upon typing the "A" character, the dropdown list will appear, displaying all of those items. The list is continually filtered as more characters are typed, eliminating the entries whose text no longer matches the typed string. For example, if the continues typing until the edit portion contains "Appl", the "Apprehend" item would be removed from the list, since the presence of the character "l" in the typed string now precludes that item.

The 'SuggestAppend' setting essentially combines the funtionality extended by the 'Append' and 'Suggest' settings. The dropdown list is automatically displayed and filtered as needed, and text is appended to the edit portion to complete the typed text to match the first item with matching text.

Setting the ValueList property can in certain circumstances interfere with the suggest mode functionality. If, for example, the property is set to reference an UltraDropDown control, suggest mode is disabled. Suggest mode support for multi-column lists is extended through the UltraCombo control; this can be enabled by assigning a reference to the UltraCombo control to the column's EditorControl property (which enables UltraCombo to serve an UltraGridComboEditor instance via its IProvidesEmbeddableEditor implementation), then setting the AutoCompleteMode property on either the column or the control.

When a ValueList instance is assigned to the ValueList property, and the UltraGridColumn.Editor property is left at its default value, or references an instance of the T:Infragistics.Win.EditorWithCombo class, suggest mode is fully supported.

See Also