Элемент управления DictionaryLookupTreeEdit (из пространства имен Ultima.Client.Controls) исполняет функционал стандартного элемента управления ComboBox и элемента управления ComboBoxEdit пакета DevExpress. Используется для выбора записи древовидного справочника:
Элемент управления обладает следующими специфичными свойствами:
•AllowClear – в значении true отображается кнопка, сбрасывающая выбранные в элементе управления значения (6);
•DictionaryType – справочник, с данными которого будет работать элемент управления;
•DisplayColumn – название свойства справочника, которое будет отображаться в дереве списка элемента управления (значение по умолчанию – Name);
•EditButtonVisible – в значении true отображается кнопка открытия формы редактирования выбранной записи (5);
•IdColumn – название свойства справочника, являющегося идентификатором (значение по умолчанию – Id);
•IDEditAutoWidth – в значении true (по умолчанию) ширина поля (1) IDEditWidth трактуется, как минимальная ширина поля (включая кнопки (2) и (3)). При этом, если вводимый идентификатор не помещается в поле (1), ширина поля автоматически увеличивается соответственно размерам вводимого номера;
•IDEditVisible – в значении true отображается поле кода записи (1). В значении false кнопки (2) и (3) смещаются направо за поле (4):
•IDEditWidth – общая ширина блока, включающего поле (1) и кнопки (2), (3);
•LookupButtonVisible – в значении true отображается кнопка, по которой раскрывается список элемента управления (2);
•ParentColumn – название свойства справочника Parent property, по которому строится дерево (значение по умолчанию – ParentID);
•SelectButtonVisible – в значении true отображается кнопка открытия списковой формы справочника для выбора записи (3).
На функционал и внешний вид DictionaryLookupTreeEdit влияет следующее свойство справочников:
•Display format – определяет формат, в котором в поле (4) элемента управления будут отображаться выбранная запись. Для приведенного в примере справочника групп товаров значение этого параметра "{ID}, {Name}". Если значение Display format не задано, формат будет сформирован из значений всех свойств справочника, кроме свойств типа LargeText и byte[].