概述

目前，OrBit平台已提供下拉值列表（ViewList/ViewListEx/ViewListPK）及窗体值列表（ViewListWindow/ViewListWindowPage）两种选项的选取方式。其中窗体值列表可以支持模糊匹配、复选、分页，但两者都存在一个小问题，那就是触摸屏用手指选取不方便，容易选错。针对这一点，现已开发出平铺按钮控件（ViewListButton）。根据后端返回的数据集，支持配置样式（按钮布局、大小、背景色、图标等）、复选数量（任意数量，1为单选）以及使能的灵活配置。根据选项的数据源，动态生成按钮。用户通过点击按钮进行选取，亦支持多页显示或只显示选定项。下面，就为大家阐述具体的应用与实现（系统配置、后端配置）。

特性介绍
1、主要对于工控或者平板等触屏终端，用手指去选取选项，很容易选错。以按钮的方式平铺展开，极大程度的方便用户选取相关选项；
2、现有的方式需要下拉或者弹窗之后，再去选取，而平铺按钮可以直接选取；
3、动态按钮：根据ViewListButton的数据源，动态绘制按钮并排列布局，点击之后调用相应的业务接口；
4、动态切换按钮的显示文本，如 上模 –>下模，上工 –>下工等切换；

应用场景
1、所有值列表选项；
2、程序功能入口界面设计（管理分支功能）

PWTileButtonGroup.dll 文件
【附件】PWTileButtonGroup.rar

应用实例展示

1 安灯异常呼叫入口界面

2 安灯异常呼叫界面

3 异常处理入口界面

4 作业计划

其他

实现步骤

1 服务器插件（PluginService）目录下，添加相关的dll文件： PWTileButtonGroup.dll。

2 平台系统参数中配置Always DowLoad参数，则每次登录Broswer时，会自动从PluginService目录下载文件到本地的Broswer安装目录。

3. 静态事务 或 元对象 中添加引用（PWTileButtonGroup.dll）
静态事务：

元对象：

4. 平铺按钮参数配置
静态事务：

元对象：

5. 后端ViewListButton数据集配置，及相关sql脚本编写

create PROCEDURE [dbo].[Test_ViewListButton]
@I_PlugInCommand varchar(5)='',--插件命令
@I_OrBitUserId char(12)='',--用户ID
@I_OrBitUserName nvarchar(100)='',--用户名
@I_ResourceId char(12)='',--资源ID(如果资源不在资源清单中，那么它将是空的)
@I_ResourceName nvarchar(100)='',--资源名
@I_PKId char(12)='', --主键ID
@I_ParentPKId char(12)='', --父元对象主键ID
@QueryParameter nvarchar(100)= null
--以上个变量为系统服务固定接口参数，必须在每一个ViewListEx过程中实现.>
as
begin
    SET NOCOUNT ON;
    SET TRANSACTION ISOLATION LEVEL READ UNCOMMITTED
    -- 按钮组整体配置
    select             
        1 AutoButtonSize, 
        5 RowInt, /* 行数 */
        4 ColInt, /* 列数 */
        1 MultipleSelectInt  /* 可选数量规则 0:可选任意项目 1:单选 >2:可选数量为指定的数量 */
    -- 单个按钮项目配置集合
    select top 20
        t.PluginId AS ButtonName,
        t.PluginName AS ButtonText
    from
        SysPlugIn t
    order by
        t.PluginId
    return 0
end

6 对象脚本实例化窗体控件，及相关业务脚本编写
静态事务：

脚本代码：

private PWUserControl.PWTileButtonGroup btg_ExceptionType = null;// 平铺按钮(异常类型) 控件
/// <summary>
/// 脚本对象实例化时加载时的方法
/// </summary>
public void ScriptLoad()
{
    this.Debug("ScriptLoad()");
    this.btg_ExceptionType = new PWUserControl.PWTileButtonGroup(this.Scripter, "ExceptionType");
    this.btg_ExceptionType.GroupSelectChanged += Btg_ExceptionType_GroupSelectChanged;
}
    private void Btg_ExceptionType_GroupSelectChanged(object sender, PWUserControl.GroupSelectChangedEventArgs e)
    {
        if (e.SeletedItems.Count == 1)
        {
            //this.Scripter.HideTab("AbnormalReporting", false);
            //this.Scripter.ActiveTab("AbnormalReporting");
            string jumpToTab;
            this.JumpToTab(this.Scripter, "GotoAbnormalReporting", out jumpToTab);
        }
    }
    /// <summary>
    /// 脚本在退出前的询问方法
    /// </summary>
    /// <returns>True则退出，False则取消退出</returns>
    public bool ScriptClosing()
    {
        if (this.btg_ExceptionType != null) this.btg_ExceptionType.Dispose();
        //to do..
        return true;
    }
    /// <summary>
    /// MES事务对象在关闭时卸载此脚本对象的方法
    /// </summary>
    public void ScriptUnLoad()
    {
        //to do..
        if (this.btg_ExceptionType != null) this.btg_ExceptionType.Dispose();
    }

元对象：

脚本代码：

        public OrBitScript.OrBitMetaAPI Scripter = new OrBitScript.OrBitMetaAPI();
        private PWTileButtonGroup tbg_ExceptionTypeItemValue = null;
        /// <summary>
        /// 脚本对象实例化时加载时的方法
        /// </summary>
        public void ScriptLoad()
        {
            this.tbg_ExceptionTypeItemValue = new PWTileButtonGroup(this.Scripter, "ExceptionType Default Group.ExceptionTypeItemValue");
            this.tbg_ExceptionTypeItemValue.Enabled = false;  
        }
        public void ScriptUnLoad()
        {
            //to do..
            if (this.tbg_ExceptionTypeItemValue != null) { this.tbg_ExceptionTypeItemValue.Dispose(); this.tbg_ExceptionTypeItemValue = null; }
        }
        public void MainRowSelected(string CellA, string CellB, string CellC, string CellD)
        {
            if (this.Scripter.TreeViewGrid.Rows.Count == 0)
            {
                this.tbg_ExceptionTypeItemValue.ClearSelet();
            }
        }
        public void EditEnter(int ModifyType, string PKId, string ParentPKId)
        {
            this.tbg_ExceptionTypeItemValue.Enabled = true;
            return;
        }
        public void EditLeave(int ModifyType, string PKId, string ParentPKId)
        {
            this.tbg_ExceptionTypeItemValue.Enabled = false;
            return;
        }

控件使用详述

1 c#脚本使用控件API

下面介绍在c#脚本使用该控件时，可以使用那些属性、方法、事件。

1.1 控件属性

1.2 控件方法

1.3 控件事件

2 ViewListButton过程配置参数说明

ViewListButton存储过程需要返回两个查询语句
1：一个是返回单条记录，平铺按钮组整体参数配置
2：一个是返回每个按钮项的配置参数集合。

2.1 平铺按钮组整体参数配置

2.2 单个按钮项参数配置

版本迭代说明

目前只在异常管理模块中应用，后续可能会进一步优化迭代。