XAF应用开发教程(七)外观控制模块

叁歲伎倆 2021-11-23 15:56 174阅读 0赞

很多时候，我们需要按照不同的条件显示不同的效果，在传统的软件开发中，我们会直接使用 控件名称.BackColor,Enable,Visible等属性进行控制。

如果一个业务对象在多处使用，要么我们会去一个地方一个地方的修改，要么会集中代码做个方法进行控制。

在XAF中，就实现了一处控制全局生效的方法。

下面我们来看看外观模块：

![669762-20151223133345593-272000405.jpg][]

上图中展示了几种效果：1，整行红色背景。2，蓝色字体加删除线。3编辑时控件禁用。4.单元格颜色变化。

![669762-20151223133608281-189029623.jpg][]

详细界面中，同样生效了，上面两幅图，一个是web的，一个winform的。

下面我们演示如何制作相同的效果：

[DefaultClassOptions]
        //[ImageName("BO_Contact")]
        //[DefaultProperty("DisplayMemberNameForLookupEditorsOfThisType")]
        //[DefaultListViewOptions(MasterDetailMode.ListViewOnly, false, NewItemRowPosition.None)]
        //[Persistent("DatabaseTableName")]
        // Specify more UI options using a declarative approach (https://documentation.devexpress.com/eXpressAppFramework/CustomDocument112701.aspx).
        [Appearance("红色禁用","ViewItem", BackColor ="Red",TargetItems ="*",Criteria ="禁用")]
        [Appearance("蓝色未审批","ViewItem", BackColor = "Blue", TargetItems = "*", Criteria = "!已审核")]
        public class 客户 : BaseObject
        {

在客户类上面写两条Appearance Attribute即可。

先看效果：

![669762-20151223135158640-2008440343.png][]

很简单的两条语句就有了效果，点击进入详细视图后，也是同样生效的。

我们再去XAFML看看外观规则：

![669762-20151223135515671-922287688.png][]

看起来比代码下面容易理解多了，但是XAF的开发人员习惯是在代码中写规则，这样更快，否则还要切换到xafml中，一会写代码，一会设置xafml也是够烦了。

所以我们的选择就是传说中的code first充血模型。

下面把上图中每个属性的功能说一下：

AppearanceItemType:要控制的项目

<table> 
 <tbody> 
  <tr> 
   <th>&nbsp;</th> 
   <th>值</th> 
   <th>说明</th> 
  </tr> 
  <tr> 
   <td><img title="Public field" src="https://documentation.devexpress.com/HelpResource.ashx?help=eXpressAppFramework&amp;document=pubfield.gif" alt="Public field"></td> 
   <td>Action</td> 
   <td>要控制的是按钮</td> 
  </tr> 
  <tr> 
   <td><img title="Public field" src="https://documentation.devexpress.com/HelpResource.ashx?help=eXpressAppFramework&amp;document=pubfield.gif" alt="Public field"></td> 
   <td>LayoutItem</td> 
   <td>详细界面中使用的布局项目的名称</td> 
  </tr> 
  <tr> 
   <td><img title="Public field" src="https://documentation.devexpress.com/HelpResource.ashx?help=eXpressAppFramework&amp;document=pubfield.gif" alt="Public field"></td> 
   <td>ViewItem</td> 
   <td>可以简单的理解为属性的名称，在详细视图中除了属性会生成对应的ViewItem,还可以手工的建立如静态文本、静态图像类的ViewItem,当然那些也在控制范围内。</td> 
  </tr> 
 </tbody> 
</table>

Context:

<table> 
 <tbody> 
  <tr> 
   <th>可选值</th> 
   <th>Appearance Rule's Activity Scope</th> 
   <th>举例</th> 
  </tr> 
  <tr> 
   <td>内置了三种类型 DetailView ListView Any.</td> 
   <td>详细视图,列表视图或所有视图.</td> 
   <td>Any</td> 
  </tr> 
  <tr> 
   <td>指定的视图ID</td> 
   <td>只生效于指定的视图.</td> 
   <td>MyClass_ListView;MyClass_DetailView</td> 
  </tr> 
  <tr> 
   <td>Any;视图名称</td> 
   <td>所有视图，但除Any后面列出的视图名称</td> 
   <td>Any;MyClass_ListView;MyClass_LookupListView</td> 
  </tr> 
  <tr> 
   <td>"DetailView" 或 "ListView" 后跟视图名称.</td> 
   <td>所有列表视图，和指定的视图</td> 
   <td>DetailView;MyClass_ListView</td> 
  </tr> 
 </tbody> 
</table>

Criteria:满足指定的条件时生效，如 年龄>20

Method:可以在指定的方法返回true值时规则才生效,如：

using DevExpress.ExpressApp.ConditionalAppearance;
    //...
    public class Product : BaseObject {
        public Product(Session session) : base(session) { }
        public decimal Price {
            //...
        }
        public ProductStatus Status {
            //...
        }
        [Appearance("RuleMethod", AppearanceItemType = "ViewItem", TargetItems = "*", Context = "ListView",
         BackColor = "Green", FontColor = "Black")]
        public bool RuleMethod() {
            if (Price < 10 && Status == ProductStatus.Active) {
                return true;
            }
            else {
                return false;
            }
        }
    }

Priority :如果有多个规则应用于同一个元素上，将按这个优先级决定哪个会生效，值越大优先级越高。

TargetItems:

<table> 
 <tbody> 
  <tr> 
   <th>示例</th> 
   <th>说明</th> 
  </tr> 
  <tr> 
   <td>"TargetElementId" 目标元素ID</td> 
   <td>比如填写属性的名称，LayoutItem的名称</td> 
  </tr> 
  <tr> 
   <td>"TargetElementId1;TargetElementId2"</td> 
   <td>多个元素的ID，使用分号分隔</td> 
  </tr> 
  <tr> 
   <td>"*"</td> 
   <td>所有元素</td> 
  </tr> 
  <tr> 
   <td>"*;TargetElementId1;TargetElementId2"</td> 
   <td>所有元素，除*号后面的指定的元素之外</td> 
  </tr> 
 </tbody> 
</table>

BackColor:背景颜色

Enable:如果指定的是ViewItem,LayoutItem是指控件是否可用。如果是按钮，是指是否可以点击。

FontColor:字体颜色

FontStyle:字体样式，比如加粗，加删除线之类的。

Visibility:是否可见。

下表展示了效果生效的环境：

<table> 
 <tbody> 
  <tr> 
   <th>个性化</th> 
   <th>列表单元格</th> 
   <th>列表编辑模式</th> 
   <th>详细视图</th> 
   <th> <p>详细视图</p> <p>静态文字</p> </th> 
   <th>布局项目</th> 
   <th>布局组、TAB</th> 
   <th>按钮</th> 
  </tr> 
  <tr> 
   <td><strong>Font Color</strong></td> 
   <td>支持</td> 
   <td>&nbsp;</td> 
   <td>支持</td> 
   <td>支持</td> 
   <td>支持</td> 
   <td>支持</td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td><strong>Font Style</strong></td> 
   <td>支持</td> 
   <td>&nbsp;</td> 
   <td>支持</td> 
   <td>支持</td> 
   <td>支持</td> 
   <td>支持</td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td><strong>Back Color</strong></td> 
   <td>支持</td> 
   <td>&nbsp;</td> 
   <td>支持</td> 
   <td>支持</td> 
   <td>支持</td> 
   <td>&nbsp;</td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td><strong>Enabled/Disabled</strong></td> 
   <td>&nbsp;</td> 
   <td>支持</td> 
   <td>支持</td> 
   <td>&nbsp;</td> 
   <td>&nbsp;</td> 
   <td>&nbsp;</td> 
   <td>支持</td> 
  </tr> 
  <tr> 
   <td><strong>Visible/Invisible</strong></td> 
   <td>&nbsp;</td> 
   <td>&nbsp;</td> 
   <td>支持</td> 
   <td><strong>&nbsp;</strong></td> 
   <td>支持</td> 
   <td>支持</td> 
   <td>支持</td> 
  </tr> 
 </tbody> 
</table>

比如，在列表中，Visible的控制，一个列表有很多行所以肯定是没办法做到有些行的内容是隐藏的，有些行的内容是可见的。

Appearance的功能就介绍到这里。

QQ4603528 群：336090194

转载于:https://www.cnblogs.com/foreachlife/p/xafappearance.html

[669762-20151223133345593-272000405.jpg]: /images/20211122/0be9f3d242784861a21fd611e5f879f8.png
[669762-20151223133608281-189029623.jpg]: /images/20211122/d9c72934e39345b9888f87e016b61ebe.png
[669762-20151223135158640-2008440343.png]: /images/20211122/6f35158398df40348ff6c4e956c53c74.png
[669762-20151223135515671-922287688.png]: /images/20211122/e3ffd741de42431ab0c28e97b411a6c3.png