信息系统开发平台OpenExpressApp － 支持勾选视图
在OpenExpressApp中部门＋岗位＝角色，功能权限属于角色的，所以功能权限也放在部门模块中设置了，后期将会单独对权限部门进行介绍，本篇讲解一下在功能权限实现中使用到的一种新的内置视图样式，我把它叫做勾选视图。
之前的列表视图
OEA的所有Command都有一个Guid，角色下功能权限下存储的实际上是不能使用的功能的Guid，如果按照以往来实现，界面如下：
界面左边为模块，右边为分组的对象功能列表，这时可以通过设计一个【选择】功能，弹出一个对话框，对话框显示所有模块的所有对象功能列表，然后通过选择后加入细表。虽然这样可以很方便的使用以前框架的功能来实现，但是用户使用起来会很不方便。这种方式，勾选一个功能需要需要点击弹出对话框，然后选择一些内容，然后关闭。而系统模块功能可能很多，这样操作就会让用户点击按钮多次。
新增的勾选视图
勾选视图界面显示如上图所示，右边把原来弹出的对话框内容显示在这里，前面加了一个checkbox框提供选择，通过勾选操作来实现以往的选择功能。现在用户新增或者去除一个功能，只需要勾选一次就可以解决，而以往操作需要3个步骤。
之前项目任务中就遇到过类似操作，当时就想实现一个通用视图来提高易用性，不过由于时间原因没有做，直到今天才完成。下面介绍一下勾选视图的主要实现和使用。
为了下面讲解时对数据说明清楚，定义一下两个术语：
源数据：勾选的列表，相当于以前弹出选择框的数据
目的数据：操作的对象列表，通过勾选操作影响到的实际对象
实现要求
- 由于这只是操作样式不一样，所以我不希望在以前的业务对象类库里加入这部分功能 ，这部分功能与类库隔离开来
- 把这个功能抽象为一中通用的样式视图，通过一些属性设置和约定来实现
- 延用以前框架代码，在之前框架代码上扩展
框架内部实现
- UI
勾选列表是一个列表视图，所以可以重用以前的ListObjectView，只是需要增加一个checkbox列。现在实现为通过附加属性来实现
public static readonly DependencyProperty IsCheckedProperty =
DependencyProperty.RegisterAttached( " IsChecked " , typeof ( bool ), typeof (SelectedDataAttached),
new FrameworkPropertyMetadata( new PropertyChangedCallback(OnIsCheckedChanged)));
/// <summary>
/// Handles changes to the IsChecked property.
/// </summary>
private static void OnIsCheckedChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
{
if (d is DataGrid)
{
DataGrid grid = d as DataGrid;
if (( bool )e.NewValue)
{
DataGridCheckBoxColumn column = new DataGridCheckBoxColumn() { Header = " 选择 " };
column.Binding = new Binding(PropertyConvention.IsSelected);
grid.Columns.Insert( 0 , column);
}
else
{
if ((grid.Columns[ 0 ] is DataGridCheckBoxColumn) && (( string )grid.Columns[ 0 ].Header == " 选择 " ))
grid.Columns.RemoveAt( 0 );
}
}
} - 数据
以前UI显示的数据是父对象的子对象列表属性（目的数据），现在需要显示为源数据，则需要修改LoadData，
对于通过本地导航获取数据的，需要修改FilterData/// <summary>
/// 装载数据，考虑(AssociationOperateType.Selected
/// </summary>
public override void LoadData()
{
base .LoadData();
if ((AllowLoadData) && (AssociationOperateType.Selected == BOsPropInfo.AssociationAttribute.AssociationOperateType))
{
LateBoundObject obj = new LateBoundObject(_data);
Data = obj.CallMethod(MethodConvention.GetList_Selected);
_destData = this .Parent.CurrentObject.GetPropertyValue(PropertyName);
(Control as UIElement).SetValue(SelectedDataAttached.DestDataProperty, _destData);
}
}
/// <summary>
/// 导航过滤数据
/// </summary>
/// <param name="queryObject"></param>
public void FilterData(IQueryObject queryObject)
{
_data = this .Parent.CurrentObject.GetPropertyValue(PropertyName);
LateBoundObject obj = new LateBoundObject(_data);
if (AssociationOperateType.Self == BOsPropInfo.AssociationAttribute.AssociationOperateType)
Data = obj.CallMethod(MethodConvention.GetList, queryObject);
else
{
Data = obj.CallMethod(MethodConvention.GetList_Selected, queryObject);
_destData = obj.CallMethod(MethodConvention.GetList, queryObject);
(Control as UIElement).SetValue(SelectedDataAttached.DestDataProperty, _destData);
}
}
- 操作
勾选时需要触发增加或者删除目的数据对象，通过在给View的Data赋值时遍历源数据每条记录的INotifyPropertyChanged事件来处理
foreach
(var srcItem
in
srcData)
{
//
属性更改触发新增删除对象
(srcItem
as
INotifyPropertyChanged).PropertyChanged
+=
delegate
(
object
sender, PropertyChangedEventArgs pe)
{
if
(pe.PropertyName.ToLower()
==
PropertyConvention.IsSelected.ToLower())
{
bool
isSelected
=
(
bool
)sender.GetPropertyValue(PropertyConvention.IsSelected);
if
(view.BOsPropInfo.AssociationAttribute.IsForwardSelected)
//
正向
{
if
(isSelected)
AddObject(sender, destData, view);
else
DeleteObject(sender, destData, view);
}
else
//
反向
{
if
(isSelected)
DeleteObject(sender, destData, view);
else
AddObject(sender, destData, view);
}
}
};
}
外部开发使用
- 设置Association属性
private
static
PropertyInfo
<
OrgPositionOperations
>
OrgPositionOperationsProperty
=
RegisterProperty(
new
PropertyInfo
<
OrgPositionOperations
>
(
"
OrgPositionOperations
"
));
[Association(AssociationOperateType
= AssociationOperateType.Selected, IsForwardSelected =false
, SelectedPropertyMap
=
"
BusinessObjectId;OperationId
"
)]
public
OrgPositionOperations OrgPositionOperations
{
get
{
if
(
!
FieldManager.FieldExists(OrgPositionOperationsProperty))
{
LoadProperty(OrgPositionOperationsProperty, OrgPositionOperations.NewChild());
}
return
GetProperty(OrgPositionOperationsProperty);
}
}
在Association属性中设置三个属性：
- AssociationOperateType = AssociationOperateType.Selected
关联操作类型，设置为Selected表示使用勾选视图，如果你把值设置为Self，或者不设置此值，那么显示结果就切换到最上面那个图了 - IsForwardSelected =false
决定勾选check值触发添加记录还是删除记录，如果为true，表示正向操作，勾选时则新增对象，去除勾选时则删除对象，如果为false，则相反 - SelectedPropertyMap = "BusinessObjectId;OperationId"
在勾选操作导致新增对象时，需要给新增对象的一些属性赋值，这些属性值来源于选择列表对象的属性，通过这个属性来映射。格式为：列表属性1=子对象属性1;列表属性2=子对象属性2，如果没有＝号，表示两个属性名称相同
- 实现选择适配类
选择类如下，同以往业务类类似，属性比以往弹出选择列表对象类相似，唯一差别就是增加了一个IsSelected属性，参考代码如下：
public
partial
class
BoInfoOperationSelectedList : GBusinessListBase
<
BoInfoOperationSelectedList, BoInfoOperationSelected
>
{...
}
[Serializable]
[BusinessObject(
"
2F1C87E1-8067-49b5-918C-230038AFA1F7
"
, PropertyGroup
=
"
ObjectName
"
), Label(
"
对象功能
"
)]
public
partial
class
BoInfoOperationSelected : GBusinessBase
<
BoInfoOperationSelected
>
{
...
private
static
PropertyInfo
<
bool
>
IsSelectedProperty
=
RegisterProperty(
new
PropertyInfo
<
bool
>
(
"
IsSelected
"
));
[EntityProperty]
[ShowInList, Label(
"
选择
"
), ShowInLookup]
public
bool
IsSelected
{
get
{
return
GetProperty(IsSelectedProperty); }
set
{ SetProperty(IsSelectedProperty, value); }
}
...
}
- GetList_Selected方法
当系统从AssociationOperateType获知是勾选视图时，系统通过约定的一个方法GetList_Selected来获取源数据，如果有导航则通过方法参数来匹配导航类，参考代码如下：
///
<summary>
///
采用选择操作对象模式时, 选择列表过滤后数据, 匹配LocalFilter
///
</summary>
///
<param name="criteria"></param>
///
<returns></returns>
public
BoInfoOperationSelectedList GetList_Selected(OrgPositionOperationCriteria criteria)
{
return
BoInfoOperationSelectedList.GetAggregationteList(criteria.BusinessObjectInfo);
}