MS CRM 2011的自定義與開發(12)——表單腳本擴展開發(5)

    之前的兩篇文章，介紹了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();
表單類型對應了當前記錄的不同狀態，對應列表如下：

表單類型值	表單類型
0	未定義
1	創建，點擊“新建”按鈕，系統彈出的表單
2	更新，編輯某條記錄時，彈出的表單
3	只讀，只有只讀權限的用戶打開記錄時的表單
4	禁用，打開處於禁用狀態的記錄的表單
5	快速創建（已經棄用）
6	批量編輯

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工具條顯示效果