Определение, подключение и регистрация в Flexberry Desinger, использование в текстовом поле и фильтрации

Предиктивный ввод позволяет модифицировать контролы для выбора мастера (LookUp) или ввода текста таким образом, чтобы система подсказывала пользователю возможные варианты по мере ввода данных.

Предиктивный ввод для LookUp

В качестве контрола-подсказчика может выступать

Подключение контрола

Чтобы подключить контрол предиктивного ввода, необходимо:

  • Зарегистрировать контрол в Стадии Flexberry Desinger
  • В E-представлении объекта указать для мастера custom-LookUp
  • Сгенерировать объекты
  • Скомпилировать объекты
  • Сгенерировать формы
  • В проекте Visual Studio установить ссылку на библиотеку с контролом

Регистрация контрола в Стадии Flexberry Desinger

Для регистрации контрола необходимо перейти на Стадию и вызвать контекстное меню, в меню Winforms -> C# -> Свойства модели.

В открывшейся форме перейти на вкладку Дополнительно и нажать на кнопку Дополнительные настройки.

В открывшейся форме дополнительных настроек необходимо в колонке Путь к сборке нажать на кнопку ... и указать путь к DLL-файлу с контролом (для контролов Winforms это файл ICSSoft.STORMNET.Windows.Forms.AdditionalControls.dll).

В диалоговой форме выбора типа необходимо отметить ExtendedLookUp, ExtLookUpTextControl или оба.

Примечание: рекомендуется использовать только ExtendedLookUp.

Сохранить настройки, нажав OK - Сохранить и закрыть

Теперь контрол зарегистрирован в стадии Flexberry Desinger.

Указание LookUp мастера в E-представлении объекта

Чтобы превратить обычный LookUp в LookUp с предиктивным вводом, необходимо указать мастеру тип используемого LookUp.

  • Открыть E-представление объекта и выделить добавленный мастер, для которого необходимо использовать предиктивный ввод.

  • В поле Тип лукапа указать custom

  • В поле Свойство мастера указать свойство мастера, по которому будет производиться поиск для предиктивного ввода.

Примечание: свойство мастера должно содержаться в представлении. Наименование свойства вводится с клавиатуры.

  • В поле Имя лукапа выбрать из выпадающего списка необходимый LookUp.

Примечание: если в выпадающем списке нет необходимого LookUp, следует к пункту Регистрация контрола в Стадии Flexberry Desinger.

  • Сохранить изменения, внесенные в представление.

Результат

Предиктивный ввод для текстового поля

Для реализации предиктивного ввода текста используется контрол ExtendedTextBox(fw_extended-textbox.html), который содержится в сборке ICSSoft.STORMNET.Windows.Forms.

Обычно используется для выбора мастерового объекта на основании некоторой строки.

Самый распространённый случай - ввод ФИО: завести справочник ФИО, настроить ExtendedTextBox на него и получить быстрый выбор среди людей, имеющихся в БД.

Свойства

  • Свойство AutoOpenListForSuggestions – при значении true автоматически открывается список для вариантов при вводе текста.
  • Свойство UseExtendedMask – при значении true варианты предлагаются при вхождении введенного текста как подстроки. Должно использоваться совместно с AutoOpenListForSuggestions = true; и MaskFormat=”%{0}%”.

Дополнение введенных слов

При вызове метода GetCurrentDataObject у ExtendedTextBox происходит дополнение введенного слова, и объект данных будет возвращен для дополненного слова. Иногда возникают ситуации, когда такое поведение нежелательно (например, при нажатии backspace). У ExtendedTextBox существует перегрузка метода GetCurrentDataObject, позволяющая указать необходимость дополнение введенного слова.

public DataObject GetCurrentDataObject(bool reloadItems)

При значении параметра reloadItems установленном в false догрузка не произойдет, при значении true вернется объект для дополненного слова.

Фильтрация записей для предиктивного ввода

Чтобы наложить дополнительную фильтрацию на выводимые предиктивным вводом подсказки, необходимо указать контролу LimitFunction, накладывающий ограничение.

Фильтрация записей для предиктивного ввода по логину			
			extTextControl1.LimitFunction = FunctionBuilder.BuildEquals("Логин", username);

Предиктивный ввод в Web-приложениях

Предиктивный ввод в Web-приложениях описан в статье Предиктивный ввод в Web-приложениях