ComboBox.AutoCompleteMode ComboBox.AutoCompleteMode ComboBox.AutoCompleteMode ComboBox.AutoCompleteMode Property

Определение

Возвращает или задает параметр, который управляет работой автоматического завершения для ComboBox.Gets or sets an option that controls how automatic completion works for the ComboBox.

public:
 property System::Windows::Forms::AutoCompleteMode AutoCompleteMode { System::Windows::Forms::AutoCompleteMode get(); void set(System::Windows::Forms::AutoCompleteMode value); };
[System.ComponentModel.Browsable(true)]
public System.Windows.Forms.AutoCompleteMode AutoCompleteMode { get; set; }
member this.AutoCompleteMode : System.Windows.Forms.AutoCompleteMode with get, set
Public Property AutoCompleteMode As AutoCompleteMode

Значение свойства

Одно из значений AutoCompleteMode.One of the values of AutoCompleteMode. Значениями являются Append, None, Suggest и SuggestAppend.The values are Append, None, Suggest, and SuggestAppend. Значение по умолчанию — None.The default is None.

Исключения

Указанное значение не равно ни одному из значений AutoCompleteMode.The specified value is not one of the values of AutoCompleteMode.

Комментарии

Используйте свойства AutoCompleteCustomSource, AutoCompleteModeи AutoCompleteSource , чтобы создать объект ComboBox , который автоматически завершает входные строки путем сравнения префикса, введенного для префиксов всех строк в поддерживаемом источнике.Use the AutoCompleteCustomSource, AutoCompleteMode, and AutoCompleteSource properties to create a ComboBox that automatically completes input strings by comparing the prefix being entered to the prefixes of all strings in a maintained source. Это полезно для ComboBox элементов управления, в которых часто записываются URL-адреса, адреса, имена файлов или команды.This is useful for ComboBox controls in which URLs, addresses, file names, or commands will be frequently entered. Если в обслуживаемом источнике есть дублирующиеся записи, автоматическое завершение ведет себя непредсказуемым образом.If there are duplicate entries in the maintained source, automatic completion behaves unpredictably.

Если задано ComboBoxStyle значение DropDownList, список отображается только в том AutoCompleteMode случае, SuggestAppendесли параметр имеет Suggest значение или.If you set ComboBoxStyle to DropDownList, the list displays only if AutoCompleteMode is Suggest or SuggestAppend.

Использование AutoCompleteCustomSource свойства является необязательным, но для его AutoCompleteSource использования AutoCompleteCustomSourceнеобходимо установить свойство CustomSource в значение.The use of the AutoCompleteCustomSource property is optional, but you must set the AutoCompleteSource property to CustomSource in order to use AutoCompleteCustomSource.

Необходимо использовать AutoCompleteMode свойства и AutoCompleteSource вместе.You must use the AutoCompleteMode and AutoCompleteSource properties together.

Если для AutoCompleteMode SuggestAppend задано AutoCompleteSource значение и ListItemsзадано значение, поведение будет следующим:With AutoCompleteMode set to SuggestAppend and AutoCompleteSource set to ListItems, the behavior is as follows:

  • Если список строк пуст, нажатие клавиши BACKSPACE или DELETE не выполняет никаких действий.If the list of strings is empty, pressing the BACKSPACE or DELETE key does nothing.

  • Если клавиша BACKSPACE нажата менее одной секунды, выбирается предыдущий элемент или ничего не выделено, если список строк пуст.If the BACKSPACE key is pressed in less than one second, the previous item is selected, or nothing is selected if the list of string is empty.

  • Если клавиша BACKSPACE нажата более одной секунды, выбирается первый элемент.If the BACKSPACE key is pressed in more than one second, the first item is selected.

  • Если нажата клавиша DELETE, выбирается первый элемент.If the DELETE key is pressed, the first item is selected.

Примечание

Операционная система может ограничить количество настраиваемых строк, которые могут отображаться одновременно.The operating system might limit the number of custom strings that it can display at once. Для строк, содержащих косую черту (/) или обратную\косую черту (), автоматическое завершение добавляет все символы, включая косую черту.For strings that contain a forward slash (/) or backward slash (\), automatic completion appends all characters only up to and including the slash.

Применяется к

Дополнительно