MasterEditorAjaxDropDown

MasterEditorAjaxDropDown - это web-контрол, который позволяет просматривать список доступных мастеровых объектов в виде выпадающего списка.

Ниже показан пример отображения данного контрола на веб-форме.

Подключение

Для того чтобы использовать MasterEditorAjaxDropDown на форме редактирования, необходимо на форме редактирования представления во Flexberry Designer выбрать тип лукапа combo, а в качестве свойства мастера указать предпочитаемое для отображения свойство объекта мастера.

Чтобы встроить данный контрол в AGE, требуется произвести настройки? аналогичные этим. При этом в WebControlProvider.xml появится запись вида:

<?xml version="1.0" encoding="utf-8" ?>
<root xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="WebControlProvider.xsd">

	...

  <!--Свойство TestSpecialControlLink у класса LimitEditorDetail2 редактируем с помощью MasterEditorAjaxDropDown.-->
  <customproperty class="LimitEditorDetail2" property="TestSpecialControlLink">
    <control typename="ICSSoft.STORMNET.Web.AjaxControls.MasterEditorAjaxDropDown, ICSSoft.STORMNET.Web.AjaxControls" property="SelectedMasterPK" codefile=""/>
    <editcontrol typename="ICSSoft.STORMNET.Web.AjaxControls.MasterEditorAjaxDropDown, ICSSoft.STORMNET.Web.AjaxControls" codefile="" property="SelectedMasterPK"/>
  </customproperty>
</root>

Использование

Использование MasterEditorAjaxDropDown уместно, когда заранее известно, что количество мастеровых объектов небольшое и нет потребности для их выбора поднимать отдельную форму выбора.

Пример кода

После генерации кода объектов и форм появятся структуры вида:

в объектах:

[MasterViewDefineAttribute("TestMasterEditorAjaxDropDownDetailView", "TestSpecialControlLink", ICSSoft.STORMNET.LookupTypeEnum.Combo, "", "PoleString")]

на веб-форме (если контрол не встроен в AGE):

<ac:MasterEditorAjaxDropDown ID="ctrlTestSpecialControlLink" CssClass="descTxt" runat="server" EnablePostBack="false"/>

Настройки контрола

Связывание контролов редактирования мастеров

О том, как связывать web-контролы редактирования мастеров (как, например, MasterEditorAjaxDropDown), описано в статье Связывание контролов редактирования мастеров.

Единообразное изменение настроек

Для единообразного изменения настроек реализовано два статических делегата:

InitDropDownSettings - Делегат для инициализации настроек. Установленные настройки можно переопределять на aspx формах.
ChangeDropDownSettings - Делегат для смены настроек, при помощи которого можно привести все MasterEditorAjaxDropDown к единообразному виду.

Пример: нужно подписаться в Global.asax:

MasterEditorAjaxDropDown.ChangeDropDownSettings = ChangeMasterEditorAjaxDropDownSettings;

/// <summary>
/// Делегат для изменения настроек <see cref="MasterEditorAjaxDropDown"/>.
/// </summary>
/// <param name="dropdown">
/// Экземпляр <see cref="MasterEditorAjaxDropDown"/>, настройки которого требуется изменить.
/// </param>
public static void ChangeMasterEditorAjaxDropDownSettings(MasterEditorAjaxDropDown dropdown)
{
    var type = Type.GetType(dropdown.MasterTypeName);
    
    // Фильтровать все виды отделки только по актуальным значениям
    if (type != null && typeof(ВидОтделки).IsAssignableFrom(type))
    {
        Function actualTypesLimitFunction = FunctionBuilder.BuildEquals<ВидОтделки>(x => x.Актуально, true);
        dropdown.LimitFunction = dropdown.LimitFunction != null 
            ? FunctionBuilder.BuildAnd(                
                dropdown.LimitFunction,
                actualTypesLimitFunction)
            : actualTypesLimitFunction;
    }
}

JS API

Для манипуляций с MasterEditorAjaxDropDown на стороне клиента следует использовать JS API, который представляет собой jQuery плагин (icsMasterEditorAjaxDropDown).

Установка значения `MasterEditorAjaxDropDown`

Для установки значения MasterEditorAjaxDropDown можно воспользоваться методом val.

Например, если по нажатию кнопки changeMasterDropDownValue требуется менять значение MasterEditorAjaxDropDown ctrlTestSpecialControlLink на указанное в контроле masterDropDownValues, то мы воспользуемся следующим кодом:

$(document).ready(function () {
	$('#<%= changeMasterDropDownValue.ClientID %>').click(function () {
		$('#<%=ctrlTestSpecialControlLink.ClientID%>').icsMasterEditorAjaxDropDown('val', $('#<%=masterDropDownValues.ClientID%>').val());
		return false;
	});
});

Возможные ошибки

Если MasterEditorAjaxDropDown отображает не только значение мастерового свойства, а весь мастеровой объект целиком, то вероятнее всего не была закончена настройка лукапа в представлении во Flexberry Designer.

Проверить это можно, удостоверившись, что у соответствующего объекта данных есть запись вида:

[MasterViewDefineAttribute("TestMasterEditorAjaxDropDownDetailView", "TestSpecialControlLink", ICSSoft.STORMNET.LookupTypeEnum.Combo, "", "PoleString")]