元对象Scripter--扩展方法 - .Net 平台应用与技巧

# **一、概述**
为了能在元对象脚本里快速写代码，实现复杂的功能，现提供了几个Scripter的扩展方法

# **二、步骤**：
1、添加OrBitUserDialog.dll引用

![](/media//202211/2022-11-29_094219.png)

2、对象脚本，导入命名空间
using OrBitUserDialog.ExClass;

3、使用方法

# **三、扩展方法**
#### 1、元字段组添加控件，一般在ScriptLoad方法中使用
```csharp
//groupNO、groupName：组号或组名字
//control： 要添加的控件，主要是网格，1个控件占用用1行
//width：控件的宽度
//height：控件的高度
Scripter.OBUD_GroupAddControl(int groupNO, Control control, int width, int height) //强制添加到组最后
Scripter.OBUD_GroupAddControl(string groupName, Control control, int width, int height)//强制添加到组最后

//添加网格（旧），直接用上面的添加控件就可以了
Scripter.OBUD_GroupAddGrid(int groupNO,Infragistics.Win.UltraWinGrid.UltraGrid grid, int width, int height)//强制添加到组最后
Scripter.OBUD_GroupAddGrid(string groupName, Infragistics.Win.UltraWinGrid.UltraGrid grid, int width, int height)//强制添加到组最后

```

```csharp
//perchControlName：主视图上的一个“占位控件”
//addControl:要添加的控件，会覆盖“占位控件”
Scripter.OBUD_GroupAddControl(string perchControlName, Control addControl)//添加到指定占位控件
```

#### 2、元字段组只展开1个（展开其中1个时，其他组会自动折叠）

说明：特别适用于分组很多时，在ScriptLoad方法中使用

```csharp
Scripter.OBUD_GroupExpandOnlySetting()

```

#### 3、创建网格，一般在ScriptLoad方法中使用

说明：会简单地对网格的外观进行了设置。

```csharp
//返回类型：Infragistics.Win.UltraWinGrid.UltraGrid
//Action dataMethod：设置网格的数据方法，方法无参数
Scripter.OBUD_CreateGrid()
Scripter.OBUD_CreateGrid(Action dataMethod)
```

```csharp
例如：
//在ScriptLoad方法中
gridA=Scripter.OBUD_CreateGrid(dataMethod)

//在脚本类OrBitClass中添加方法
private void dataMethod()
{
	string sql="select top 10 * from bill";
	DataSet ds=Scripter.GetSqlDataSet(sql);
	gridA.DataSource=ds;
}
```

![](/media//202211/2022-11-29_101219.png)

![](/media//202211/2022-11-29_102437.png)

#### 4、整个“主视图”变成 1个网格，避免切换页签查看
```csharp
//返回Infragistics.Win.UltraWinGrid.UltraGrid 类型
//Action dataMethod：设置网格的数据方法，方法无参数，如同OBUD_CreateGrid方法1样
Scripter.OBUD_MainViewPanelToGrid( Action dataMethod)
```

![](/media//202211/2022-11-29_102057.png)

![](/media//202211/2022-11-29_102134.png)

#### 5、获取元对象主视图字段控件，无需指定组
```csharp
//返回Control类型
Scripter.OBUD_GetParameterControl(string Parameter)
```

#### 6、值列表模糊搜索
```csharp
//值列表模糊搜索，只允许用于非过滤值列表（在ScriptLoad方法里调用）
Scripter.OBUD_UltraCombo_FuzzySearchSet(List<string> listControl)
//--对于子页签的值列表模糊搜索，需要手动刷新（在EditEnter方法里调用）
Scripter.OBUD_UltraCombo_FuzzySearchRefresh(List<string> listControl)

```

#### 7、通过WebView2展示看板
有时候需要在元对象主视图中显示看板，但用IE内核展示有问题，现提供Chrome 内核展示看板方法，代码如下：

```csharp
//字段说明
//groupNO:主视图上的组号
//webUid:创建WebView2控件的控件名字。注意:不要与主视图的字段重复
//sourceUrl:WebView2控件的Source属性，源地址
//dockStyle:停靠风格
//width:宽度
//height:高度
//navigateUrl:导航地址

//1.主视图增加WebView2控件
Scripter.OBUD_WebBrowserAdd(int groupNO, string webUid, string sourceUrl, DockStyle dockStyle, int width = 800, int height = 600)
//2.WebView2控件设置导航地址，每个看板的刷新地址。说明：如果OBUD_WebBrowserAdd上已指定sourceUrl，此sourceUrl参数可为空
Scripter.OBUD_WebBrowserNavigate(string webUid, string sourceUrl, string navigateUrl)
//3.释放WebView2资源，在ScriptClosing()方法里调用。注意：一定要调用
Scripter.OBUD_WebBrowserDispose(string webUid)

```
**效果：**
![](/media//202305/2023-05-25_105800.png)

#### 8、网格模糊搜索
有时候需要在网格上（比如树视图）执行快速模糊搜索，代码如下：
```csharp
//grid:网格对象
//gridParameterName：主视图上的网格参数名，通过此参数获取网格对象
//searchStr：要搜索的内容，可以同时搜索多个
Scripter.OBUD_GridFuzzySearch(Infragistics.Win.UltraWinGrid.UltraGrid grid, string[] searchStr)

Scripter.OBUD_GridFuzzySearch(string gridParameterName, string[] searchStr)
```