之前的两篇文章,介绍了Microsoft Dynamics CRM 2011开发中表单脚本的数据管理器Xrm.Page.data方面的内容,下面介绍UI管理器Xrm.Page.ui方面的内容。
Xrm.Page.ui对象包括了两大类内容:
第一类,是一组方法,用于获取当前用户界面中的信息;
第二类,是一些集合,这些集合对应了一组组的界面上同类界面元素。
下面,首先说一下获取UI信息的方法
方法 |
描述 |
||||||||||||||||
close | 关闭当前表单。 使用方法Xrm.Page.ui.close() 注意:尽量不要使用window.close()方法关闭表单,而应该使用Xrm.Page.ui.close()方式关闭表单,因为使用这种方式关闭表单,对于用户修改过表单中某些字段值的情况下,系统会弹出提示,是否进行保存。 |
||||||||||||||||
getCurrentControl | 获取当前获得焦点的界面元素控件 使用方法Xrm.Page.ui.getCurrentControl(); |
||||||||||||||||
getFormType | 获取记录的表单上下文,换言之,获取表单的类型 使用方法Xrm.Page.getFormType(); 表单类型对应了当前记录的不同状态,对应列表如下:
|
||||||||||||||||
getViewPortHeight | 获取视口(viewport)的高度 使用方法Xrm.Page.ui.getViewPortHeight() 所谓视口viewport,也就是包含表单数据的页面区域,对应了表单的正文body部分,而不包括导航区、标题区和页脚区,以及表单帮助区 |
||||||||||||||||
getViewPortWidth | 获取视口(viewport)的宽度 使用方法Xrm.Page.ui.getViewPortWidth() 所谓视口viewport,也就是包含表单数据的页面区域,对应了表单的正文body部分,而不包括导航区、标题区和页脚区,以及表单帮助区 |
||||||||||||||||
refreshRibbon | 刷新表单上的Ribbon工具条,从而强制系统重新计算、评估以确定Ribbon工具条中的内容 使用方法Xrm.Page.ui.refreshRibbon(); 注意:这个方法主要用在了Ribbon中的EnableRule规则元素中,当该规则元素将表单某个字段值作为判断依据时,当脚本代码更改了字段值之后,使用refreshRibbon()方法,强制系统重新计算,从而刷新Ribbon工具条显示效果 |