元对象帮助类OrBitMetaHelp - .Net 平台应用与技巧

# 一、概述
为了能在元对象上实现一些特殊且必须的需求，让产品功能更加合理，更符合实际使用，现提供了元对象帮助类，里面集成了很多方法，用于操作元对象，实现功能扩展。

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

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

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

3、创建对象
OrBitMetaHelp orBitMetaHelp=new OrBitMetaHelp(Scripter);

# **三、方法**
#### 1、获取第一页签的SplitContainer
```csharp
 /// <summary>
 /// 获取第一页签的SplitContainer
 /// </summary>
 /// <returns></returns>
 public SplitContainer GetFirstSplitContainer()

```

#### 2、获取第一页签的SplitContainer
```csharp
/// <summary>
/// 获取第一页签的SplitContainer
/// </summary>
/// <param name="ultraTab">ultraTab</param>
/// <returns></returns>
public SplitContainer GetFirstSplitContainer(UltraTab ultraTab)

```

#### 3、获取当前页签的【UltraTab控件】
```csharp
 /// <summary>
 /// 获取当前页签的【UltraTab控件】
 /// </summary>
 /// <returns></returns>
 public UltraTab GetTab()

```

#### 4、获取当前插件的“UltraTabControl控件”
```csharp
 /// <summary>
 /// 获取当前插件的“UltraTabControl控件”
 /// </summary>
 /// <returns></returns>
 public UltraTabControl GetTabControl()

```

#### 5、获取其他页签的【UltraTab控件】
````csharp
 /// <summary>
 /// 获取其他页签的【UltraTab控件】
 /// </summary>
 /// <param name="MetadataName">元对象名</param>
 /// <returns></returns>
 public UltraTab GetOtherTab(string MetadataName)

````

#### 6、获取指定页签的"网格对象"
````csharp
/// <summary>
/// 获取指定页签的"网格对象"
/// </summary>
/// <param name="ultraTab">UltraTab 页签</param>
/// <returns></returns>
public UltraGrid GetTabGrid(UltraTab ultraTab)

````

#### 7、获取指定页签的"网格对象"
````csharp
 /// <summary>
 /// 获取指定页签的"网格对象"
 /// </summary>
 /// <param name="MetadataName">元对象名</param>
 /// <returns></returns>
 public UltraGrid GetTabGrid(string MetadataName)

````

#### 8、获取指定页签的"MainViewPanel对象"
````csharp
/// <summary>
/// 获取指定页签的"MainViewPanel对象"
/// </summary>
/// <param name="ultraTab">UltraTab 页签</param>
/// <returns></returns>
public UltraExplorerBar GetTabMainViewPanel(UltraTab ultraTab)

````

#### 9、获取指定页签的"MainViewPanel对象"
````csharp
/// <summary>
/// 获取指定页签的"MainViewPanel对象"
/// </summary>
/// <param name="MetadataName">元对象名</param>
/// <returns></returns>
public UltraExplorerBar GetTabMainViewPanel(string MetadataName)

````

#### 10、 获取指定页签主视图面板上的控件
````csharp
/// <summary>
/// 获取指定页签主视图面板上的控件
/// </summary>
/// <param name="MetadataName">元对象名称</param>
/// <param name="ParameterName">控件参数名</param>
/// <returns></returns>
public Control GetTabParameterControl(string MetadataName, string ParameterName)

````

#### 11、获取指定页签的"ToolStrip对象"
````csharp
 /// <summary>
 /// 获取指定页签的"ToolStrip对象"
 /// </summary>
 /// <param name="ultraTab">UltraTab 页签</param>
 /// <returns></returns>
 public ToolStrip GetTabToolStrip(UltraTab ultraTab)

````

#### 12、获取指定页签的"ToolStrip对象"
````csharp
/// <summary>
/// 获取指定页签的"ToolStrip对象"
/// </summary>
/// <param name="MetadataName">元对象名</param>
/// <returns></returns>
public ToolStrip GetTabToolStrip(string MetadataName)

````

#### 13、返回FtpFile 信息
````csharp
/// <summary>
/// 返回FtpFile 信息
/// </summary>
/// <param name="FtpFileId">FtpFileId</param>
/// <returns>FtpFileInfo</returns>
public FtpFileInfo GetFtpFileInfo(string FtpFileId)
````

#### 12、Excel导出
````csharp
/// <summary>
/// Excel导出
/// </summary>
/// <param name="dt">数据表</param>
/// <param name="fileName">默认文件名，可空</param>
public void ExcelExport(DataTable dt, string fileName)

````

#### 14、Excel导出2
````csharp
/// <summary>
/// Excel导出
/// </summary>
/// <param name="dt">数据表</param>
/// <param name="fileName">默认文件名。可空</param>
/// <param name="columnWith">列宽。可null</param>
public void ExcelExport(DataTable dt, string fileName, Dictionary<string, int> columnWith)
````

#### 12、显示代码，窗体
````csharp
/// <summary>
/// 显示代码，窗体
/// </summary>
/// <param name="winCaption">标题</param>
/// <param name="codeText">代码</param>
/// <param name="isSql">是否是sql</param>
public void ShowCodeWindow( string winCaption, string codeText, bool isSql)

````

#### 15、添加多行搜索
````csharp
/// <summary>
/// 添加多行搜索
/// </summary>
public void AddMultiLineSearch()

````

#### 16、文本比较，显示差异
````csharp
  /// <summary>
  /// 文本比较，显示差异
  /// </summary>
  /// <param name="frmName">窗体名称</param>
  /// <param name="titleA">titleA</param>
  /// <param name="titleB">titleB</param>
  /// <param name="textA">textA</param>
  /// <param name="textB">textB</param>
  /// <returns></returns>
  public bool ShowDifferences(string frmName,string titleA, string titleB, string textA, string textB)

````

# **四、例子**
#### 1、应用例子，例如，使用多行搜索
```csharp
/// <summary>
/// 元对象插件接口全局对象，它提供了操作元对象的接口属性与接口方法
/// </summary>
public OrBitScript.OrBitMetaAPI Scripter = new OrBitScript.OrBitMetaAPI(); 
OrBitMetaHelp orBitMetaHelp=null;//申明
	
/// <summary>
/// 脚本对象实例化时加载时的方法
/// </summary>
public void ScriptLoad()
{
    //to do..
	orBitMetaHelp=new OrBitMetaHelp(Scripter);//定义对象
	
	orBitMetaHelp.AddMultiLineSearch();//添加多行搜索
}
```