Уроки XAF

Для корректной работы необходимо, чтобы в модели для свойства DefaultLookupEditorMode класса, для которого настраивается список выбора, было выбрано значение Search из перечисления LookupEditorMode (подробнее здесь), либо чтобы при выбранном по умолчанию значении Auto количество объектов класса было достаточно большим, чтобы редактор свойств при открытии списка выбора автоматически включил режим поиска без показа всего списка объектов. В противном случае событие CustomBuildCriteria не вызывается.

Для тестирования модуля в стороннем XAF-приложении следует открыть в Microsoft Visual Studio проект модуля и присоединиться к запущенному XAF-приложению с подключенным модулем (пункт меню “Отладка/Присоединиться к процессу…”).

Для локализации XAF-приложения можно также использовать изменение модели приложения (подробнее здесь и здесь).

Для изменения того, насколько подробный журнал будет вестись при работе XAF-приложения, необходимо в конфигурационном файле приложения изменить значение ключа eXpressAppFramework, определенного в разделе "system.diagnostics\switches". Возможные значения ключа: 0-Off, 1-Errors, 2-Warnings, 3-Info, 4-Verbose (подробнее здесь). По умолчанию используется значение 3.

Для того, чтобы изменить расположение файла сборки ModelAssembly.dll по сравнению с заданным в ключе UserModelDiffsLocation следует переопределить метод GetModelAssemblyFilePath класса, унаследованного от класса WinApplication. При этом следует учитывать следующий факт. Если в значении ключа UserModelDiffsLocation указать значение None и при этом вернуть из метода GetModelAssemblyFilePath значение, отличное от null, то одновременный запуск нескольких экземпляров приложения из одной и той же папки будет невозможен из-за ошибки одновременного доступа к файлу ModelAssembly.dll.

Для реализации отличной от стандартной процедуры аутентификации пользователей следует определить класс, являющейся наследником класса AuthenticationBase и реализующий интерфейс IAuthenticationStandard (подробнее здесь). Необходимо обратить внимание на то, что хотя интерфейс IAuthenticationStandard и не содержит ни одного метода, но отсутствие его в объявлении класса приводит к тому, что часть стандартных действий (actions) в списочном и детальном представлении пользователей становится недоступным. В частности, в детальном представлении пользователя скрывается действие "Сброс пароля" и перестает работать опция "Сменить пароль при первом входе".

Необходимо обратить внимание на несоответствие между именем коллекции и её содержимым (подробнее здесь).

Свойства ShowColumnGrandTotals и ShowRowGrandTotals, доступные в объектах класса PivotGridControl, позволяют независимо изменять видимость итогов по столбцам и строкам сводного представления. Необходимо обратить внимание на то, что изменение значения этих свойств в модели представления (пункт PivotSettings представления) не работает. Также стоит отметить, что изменение значения свойства ShowGrandTotal для поля с данными (DataArea) в модели приложения (пункт PivotSettings\Settings\PivotGrid Fields\Options представления) одновременно скрывает/отображает как итоги по строкам, так и по столбцам.

Возможность сохранение изменений модели приложения и пользовательской модели в базе данных появилась в DevExpress 14.2 (см. подробнее). Также данная возможность реализована в соответствующей версии Xafari (см. подробнее).

При запуске XAF-приложения происходит проверка совпадения версий модулей в базе данных (таблица ModuleInfo) и папке приложения (версия сборки). При не совпадении версий модулей выдается сообщение об ошибке и приложение завершает свою работу (см. подробнее). Необходимо обратить внимание на то, что текст сообщения об ошибке зависит от соотношения версий модулей. А именно, если версия модуля больше в базе данных, то в сообщении об ошибке будет указано имя модуля, что облегчает исправление проблемы. А в том случае, когда версия модуля больше в файле в папке приложения, то сообщение об ошибке не содержит имя модуля с различающейся версией.

Для запрещения редактирования выбранного значения в элементе управления ComboBoxEdit необходимо изменить значение свойства RepositoryItemButtonEdit.TextEditStyle на TextEditStyles.DisableTextEditor.

Для отмены закрытия окна при выполнении действия PopupWindowShowAction следует в обработчике события Execute присвоить значение false свойству CanCloseWindow параметра обработчика события типа PopupWindowShowActionExecuteEventArgs.

XRRichText text = new XRRichText(); text.WidthF = cell.WidthF; text.Borders = BorderSide.None; text.Font = cell.Font; text.Html = "Hello, <b>world!</b>"; cell.Controls.Add(text);

PivotGridControl control = ((View as ListView).Editor as PivotGridListEditor).PivotGridControl; foreach (Point cell in control.Cells.MultiSelection.SelectedCells) { PivotDrillDownDataSource rows=control.Cells.GetCellInfo( cell.X, cell.Y).CreateDrillDownDataSource(); for (int i = 0; i < rows.RowCount; i++) { object source = (control.DataSource as ProxyCollection)[ rows[i].ListSourceRowIndex] as object; } }

foreach (ListPropertyEditor item in (View as DetailView).GetItems<ListPropertyEditor>()) { if (item.Caption == "Позиции документа учета") { object current=item.ListView.CurrentObject; break; } }

(View.ObjectSpace as XPObjectSpace).Owner as DetailView;

Для переключение внешнего вида XAF-приложения необходимо в модели приложения открыть раздел Options и изменить значение свойства UIType (см. подробнее).