TextBox::AutoCompleteMode Property
Gets or sets an option that controls how automatic completion works for the TextBox.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
public: [BrowsableAttribute(true)] property AutoCompleteMode AutoCompleteMode { AutoCompleteMode get(); void set(AutoCompleteMode value); }
Property Value
Type: System.Windows.Forms::AutoCompleteModeOne of the values of AutoCompleteMode. The following are the values.
- Append
Appends the remainder of the most likely candidate string to the existing characters, highlighting the appended characters.
- Suggest
Displays the auxiliary drop-down list associated with the edit control. This drop-down is populated with one or more suggested completion strings.
- SuggestAppend
Appends both Suggest and Append options.
- None
Disables automatic completion. This is the default.
| Exception | Condition |
|---|---|
| InvalidEnumArgumentException | The specified value is not one of the values of AutoCompleteMode. |
Use the AutoCompleteCustomSource, AutoCompleteMode, and AutoCompleteSource properties to create a TextBox that automatically completes input strings by comparing the prefix being entered to the prefixes of all strings in a maintained source. This is useful for TextBox controls in which URLs, addresses, file names, or commands will be frequently entered.
The use of the AutoCompleteCustomSource property is optional, but you must set the AutoCompleteSource property to CustomSource in order to use AutoCompleteCustomSource.
You must use the AutoCompleteMode and AutoCompleteSource properties together.
Note |
|---|
The operating system might limit the number of custom strings that it can display at once. |
The following code example demonstrates how to use a collection as the auto-complete custom source for a TextBox control. This example does the following:
Uses the AutoCompleteSource property to enable the TextBox control to accept a custom source for its auto-complete behavior.
Uses the AutoCompleteCustomSource property to set the custom list of values.
Uses the AutoCompleteMode property to set how the auto-complete candidates are displayed.
Available since 2.0
