根據目前的值將變更套用至查閱，就像使用者即將檢視查閱的結果一樣。
支援的控制項類型
查詢
語法
formContext.getControl(arg).addPreSearch(myFunction)
參數
| 名稱 | 類型 | 為必填項目 | Description |
|---|---|---|---|
myFunction |
功能 | Yes | 在搜尋之前執行的函數，以提供查閱的結果。 您可以使用此函式來呼叫其中一個其他查閱控制項函式，並改善要在查閱中顯示的結果。 執行內容會自動作為第一個參數傳遞給此函數。 |
Example
在下列範例中， onLoad 會針對表單onload事件設定函式。 它會修改與查閱屬性相關 primaryid 聯之所有查閱控制項的搜尋篩選器，因為可能有多個。
它使用該addPreSearch方法添加myPreSearchCallBack函數。 此範例要求傳回的所有聯絡人記錄的值都為 firstname 「Eric」。
function onLoad(executionContext) {
var formContext = executionContext.getFormContext()
var attribute = formContext.getAttribute("primarycontactid")
attribute.controls.forEach(control => control.addPreSearch(myPreSearchCallBack))
}
function myPreSearchCallBack(executionContext) {
var control = executionContext.getEventSource();
var filter = "<filter><condition attribute='firstname' operator='eq' value='Eric' /></filter>";
control.addCustomFilter(filter);
}