点击获取工具>>

零碎背景
  • 平台：Frameworks (XAF & XPO)
  • 产品：eXpressApp Framework

在某些状况下，可能须要在UI中创立其余性能区域来显示特定数据。通过在XAF模板中蕴含其余控件并实现将数据提供给控件的代码，能够解决此工作。 为了帮忙您实现工作，XAF提供内置的CustomizeTemplateViewControllerBase控制器以及对内置模板的残缺设计时反对。 联合应用这些性能，您能够轻松实现信息面板，该面板能够显示操作、视图以及可从View Controller拜访的任何类型的数据，本文为大家介绍创立简略信息面板所需执行的步骤。

在应用程序中蕴含必须的模板

首先您须要确定要自定义的模板，在应用程序的不同局部中应用不同的模板。在本文中，将自定义Windows Forms MainForm和DetailViewForm模板以及ASP.NET DefaultVertical模板。

Windows Forms模板

内置Windows Forms模板是位于DevExpress.ExpressApp.Win程序集中的惯例类，要自定义它们，您须要在解决方案中蕴含相应的源代码文件并解决XafApplication.CreateCustomTemplateevent。

ASP.NET模板

内资的ASP.NET模板其内容来自于位于DevExpress.ExpressApp.Web程序集中的用户控件页面，要自定义它们，您须要在解决方案中蕴含相应的源代码文件，并批改通过WebApplication.Settings属性公开的适当设置。

解决方案中蕴含所有必须的模板后，即可开始向其中增加面板控件。

将Panel Controls增加到Windows Forms Templates

要将面板控件增加到MainForm或DetailViewForm模板中，请在Solution Explorer中右键单击该模板，而后抉择"View Designer"。

找到viewSitePanel控件，并将其Dock属性从Fill更改为None。

为了确保能够正确调整模板的大小，请将SplitContainerControl的Dock属性设置为Fill，将FixedPanel属性设置为Panel2。

为了可能用信息填充信息面板，SplitContainerControl必须在内部可见。 为此定义一个界面，通过该界面能够访问信息面板，这将使数据提供控制器与特定模板类型脱钩，相同他们将依赖接口。

`public interface IInfoPanelTemplateWin : IFrameTemplate {
DevExpress.XtraEditors.SplitContainerControl SplitContainer { get; }
}`

而后，在模板中实现接口。

`public partial class MainForm : MainFormTemplateBase, IDockManagerHolder,
ISupportClassicToRibbonTransform, IInfoPanelTemplateWin {
//...
public DevExpress.XtraEditors.SplitContainerControl SplitContainer {
get { return splitContainerControl1; }
}
}`

将面板控件增加到ASP.NET Web模板

要将面板控件增加到DefaultVertical模板，请右键单击您增加的ASCX文件，以代替规范DefaultVertical内容，而后抉择 "View Markup"。

将以下两个单元格增加到MRC表。
`<td id="RS" style="width: 6px; border-bottom-style: none; border-top-style: none"
class="dxsplVSeparator_<%= BaseXafPage.CurrentTheme %>
dxsplPane_<%= BaseXafPage.CurrentTheme %>">
<div id="RSB" class="dxsplVSeparatorButton_<%= BaseXafPage.CurrentTheme %>"
onmouseover="OnMouseEnter('RSB')"
onmouseout="OnMouseLeave('RSB')" onclick="OnClick('Right', 'RSI')">
<div id="RSI" style="width: 6px;"
class="dxWeb_splVCollapseForwardButton_<%= BaseXafPage.CurrentTheme %>"/>
</div>
</td>
<td id="Right" width="250px" style="vertical-align: top">
<cc3:XafUpdatePanel ID="UPRight" runat="server" />
</td>`

该标记中的UPRight控件将代表信息面板。

关上ASCX的代码暗藏文件 - 右键单击该文件，而后抉择View Code。

通过公开属性公开protected UPRight控件。
`public partial class MyDefaultVerticalTemplateContent : TemplateContent {
public Control PlaceHolder {
get { return UPRight; }
}
// ...
}`
在ASP.NET模块我的项目中，定义一个接口，控制器将通过该接口访问信息面板。
`public interface IInfoPanelTemplateWeb : IFrameTemplate {
Control PlaceHolder { get; }
}`
在Default模板中实现此接口 - 编辑位于ASP.NET应用程序我的项目中的`Default.aspx.cs文件。
public partial class Default : BaseXafPage, IInfoPanelTemplateWeb {
public Control PlaceHolder {
get {
return TemplateContent is MyDefaultVerticalTemplateContent
? ((MyDefaultVerticalTemplateContent)TemplateContent).PlaceHolder : null;
}
}
// ...
}`
当初，您须要实现Windows Forms和ASP.NET Web View Controllers，它们将为面板控件提供理论数据。为简化此工作，XAF提供要继承的CustomizeTemplateViewControllerBase Controller，为不便起见，TemplateType泛型参数能够是模板类型，也能够是由模板实现的接口。 CustomizeTemplateViewControllerBase曾经提供了模板拜访逻辑，因而您所要做的就是实现四个受爱护的形象办法。

  • AddControlsToTemplateCore(TemplateType template) - 激活Controller后调用，此办法必须实例化所须要的控件并将其增加到信息面板中。
  • RemoveControlsFromTemplateCore(TemplateType template) - 停用Controller时调用，此办法必须从信息面板中删除以前增加的控件。
  • UpdateControls(View view) - 以后视图更改时调用，如果须要，此办法必须应用特定于视图的信息更新信息面板控件。
  • UpdateControls(object currentObject) - 以后显示的对象更改时调用，如果须要，此办法必须应用特定于以后显示对象的数据更新信息面板控件。

留神：您能够拜访XAF模板并对其进行自定义，来为您的工作实现规范的ASP.NET技术（例如，应用HTTP处理程序提供动静内容）。