Smobiler的复杂控件的由来与创造

Posted 2022-08-09 smobiler

Smobiler的复杂控件的由来与创造

存在意义

Smobiler的复杂控件即利用自定义控件的方式组合控件，来使控件成为一个有机整体，里面的控件可相互协作交互，并使其达到高可用。

在Smobiler中有许多基础控件，TextBox文本输入框控件可以调用输入法在界面上自由输入文字，Image图片显示控件可以在界面的任意位置显示图片，Label文本显示控件可以在界面的任意位置显示文本，Panel容器控件可存放其他控件。这些控件都是单独的功能，而我们设计界面不可能只有使用一个控件，这时我们就需要组合相同与不同的控件来为我们服务。比如需要一个可显示图片并且图片下方有文字注释，并且当点击图片时可触发点击事件来跳转另一个详细的介绍界面，此时就需要使用Panel、Image、Label这些基础的控件来组合使用。

那么问题来了，当我同一个界面需要多次使用上面的Image组合控件，我是否需要一次又一次的手动组合控件呢？那我整个项目中不同的界面中又需要无数次的使用上面的Image组合控件，是否需要做无数次的相同工作？答案是：并不需要！Smobiler中有自定义控件的功能，顾名思义自定义控件就是用户可根据自己的需要定制自己的控件，自定义的控件可在工具箱中显示。

当你在界面中需要运用多个相同的或者不同的控件，组合成一个各个控件相互关联的大整体，并且实现了高复用。你可以设计方法，设计属性，设计回调事件，使用这些随心所欲控制自己定制的复杂控件。

可实现的场景

复杂控件即可满足多种多样复杂场景。下面以一部分Smobiler官方推出的复杂控件为例：

• AlbumView控件 —— 相册控件，可设置缩略图点击后查看原图。用户可使用该控件展示图片。AlbumView控件主要由Panel、Image、PageView、Button、FontIcon基础控件组合而成。
  

• ImageButton控件 —— 含图片的按钮控件，可点击图片触发点击事件。
  ImageButton控件主要由Panel、Image、Label基础控件组合而成。
  

• ListMenuView控件 —— 列表菜单控件，可快速显示列表信息。
  ListMenuView控件主要由Panel、Label、ImageButton、ImageEx组成。
  

• Numeric控件 —— 数量控件。即可输入数量，又可以点击按钮增加或减少数量。Numeric控件主要由TextBox、FontIcon组成。
  

• Poplist控件 —— 弹出列表选择控件，可在选择在界面弹出选择框选择相应的信息。Poplist控件主要由Panel、Label、FontIcon、Button组成。
  

• Radiogroup控件 —— 选择控件，同样功能不同样式的选择控件。RadioGroup控件主要由CheckBox、Label组成。
  

• RatingBar控件 —— 评价控件，评分条控件可进行评价打分。RatingBar控件主要由Panel、FontIcon组成
  

• TableView控件 —— 表格控件，可以表格的样式显示信息。TableView控件主要由Panel、Button、Image、CheckBox、Label、TextBox组成。
  

• ToolBar控件 —— 工具栏控件，此控件可应用于底部点击显示不同的界面。ToolBar控件主要由Panel、ImageEx、Label组成。
  

施展创造

样式

下面我们就仿照Numeric控件的样式不使用设计器以纯代码的方式做一个复杂控件。
首先我们创建一个新的类取名为Numeric，如下图：

之后代码中取名为数量控件。

/// <summary>
/// 数量控件
/// </summary>
//下面代码可使控件显示在工具箱中。
[System.ComponentModel.ToolboxItem(true), System.ComponentModel.ToolboxItemFilter("Smobiler.Core.Controls")]
//取名，继承MobileLayoutControl布局控件、IMobileBindableControl数据绑定控件接口
public class Numeric : MobileLayoutControl, IMobileBindableControl
   

接下来我们就需要设计显示Numeric了。Numeric控件时由Panel、FontIcon、TextBox组成，先创建下列控件。

    //Numeric中间的输入框
    private TextBox txtValue;
    //Numeric左边的减少的图标
    private FontIcon fontMinus;
    //Numeric右边的增加的图标
    private FontIcon fontPlus;
    //使左边图标可点击
    private Panel Minus;
    //使右边图标可点击
    private Panel Plus;

主要控件创建完毕后，就需要设计这个基础控件的显示样式了。

    /// <summary>
    /// 初始化Numeric类的一个新实例
    /// </summary>
    public Numeric()
    
        //本界面使用相对布局的方式，可按照自己顺手方式。
        this.Layout = LayoutPosition.Relative;
        //最外层添加一个Panel装所有的控件。
        Panel NPanel = new Panel();
        NPanel.Layout = LayoutPosition.Relative;
        //numeric需要横向排列设置容器主轴方向为Row。
        NPanel.Direction = LayoutDirection.Row;
        //在相对布局下使用Flex属性撑满界面
        NPanel.Flex = 1;
        NPanel.Width = 0;

        //设计左边可点击的Panel样式
        Minus = new Panel();
        Minus.Touchable = true;
        Minus.Layout = LayoutPosition.Relative;
        Minus.Flex = 1;
        Minus.Height = 0;
        Minus.Padding = new Padding(5, 0, 0, 0);
         Minus.BackColor = System.Drawing.Color.Transparent;

       //设计左边的减少的图标的样式
       fontMinus = new FontIcon
        
            FontName = FontIconName.FontAwesome,
            ResourceID = "minus-circle",
            ForeColor = System.Drawing.Color.DarkGray,
            Width = 0,
            Flex = 1
        ;
       //设计完样式之后把图标放入Panel容器中，即右边点击图标部分即完成了。
       Minus.Controls.Add(fontMinus);

     //以同样的方式设计右边的点击图标。
     .......
     .......
     Plus.Controls.Add(fontPlus);

     //设计中间的TextBox的样式。
     txtValue = new TextBox();
     txtValue.Text = mValue.ToString();
     //相对布局中设置txtValue的Flex为3，则对比Minus与Plus的1，表示txtValue为同一容器中大小占据3的份额，Minus与Plus个占据1.
     txtValue.Flex = 3;
     txtValue.Height = 0;
     txtValue.FontSize = 18;
     txtValue.KeyboardType = KeyboardType.Numeric;
     txtValue.HorizontalAlignment = HorizontalAlignment.Center;
     txtValue.BackColor = System.Drawing.Color.Transparent;

     //所有的样式都设计完了，这时就可以组合在一起了。
     NPanel.Controls.AddRange(new MobileControl[]  Minus, txtValue, Plus );
        //自定义控件需要添加在SmobilerUserControl。
        var mControls = new MobileControlCollection();
        //注册控件的集合
        base.RegisterControls(mControls);
        mControls.Add(NPanel);
    

内部功能

此时与Numeric相同的样式即实现了。但是相同的样式并不能满足需求，我们还需要实现里面的逻辑，使之成为有功能的Numeric。

实现panel中的点击事件：

        Minus.Press += (obj, args) =>
        
            if (string.IsNullOrEmpty(txtValue.Text.Trim()) == false)
            
                decimal inputValue = 0;
                if (decimal.TryParse(txtValue.Text, out inputValue) == true)
                
                    Value = inputValue - Variation;
                    initValue = Value;
                
                else
                
                    Value = Value;
                
            
            else
                Value = mMinValue;
            
        ;

实现txtValue原本的事件：

 txtValue.TextChanged += (obj, args) =>
        
         ......
        ;
 txtValue.TouchEnter += (obj, args) =>
        
         ......  
        ;
        txtValue.TouchLeave += (obj, args) =>
        
         ......    
        ;

属性

添加Numeric的属性Value，可通过属性设置显示的值。

    private decimal mValue = 0;
    /// <summary>
    /// 设置控件显示的默认值
    /// </summary>
    [Browsable(true), Category("Behavior"), DefaultValue(typeof(decimal), "0"), Description("显示默认值")]
    public decimal Value
    
        get
        
            return mValue;
        
        set
        
            //添加判断
            value = (decimal)Math.Round(value, mDecimals);

            if (this.Parent != null && this.Parent.Controls.Contains(this) == true && (value > mMaxValue))
                value = MaxValue;
            else if (this.Parent != null && this.Parent.Controls.Contains(this) == true && (value < mMinValue))
                value = MinValue;
            if (initValue==value)
            
                TextChanged = false;
                mValue = value;
            
           else if (mValue != value||TextChanged==true)
            
                TextChanged = false;
                mValue = value;
                //if (ValueChanged != null)
                //ValueChanged.Invoke(this, new EventArgs());
            
            //给txtValue赋值显示。
            txtValue.Text = mValue.ToString("f" + Decimals);
        
    

方法

可以上面的方式添加不同的属性。
也可添加控件的方法：

    /// <summary>
    /// 使控件获取焦点。
    /// </summary>
    public void Focus()
    
        txtValue.Focus();
    
    /// <summary>
    /// 使控件失去焦点。
    /// </summary>
    public void Blur()
    
        txtValue.Blur();
    

绑定的属性

另外可实现绑定的属性，即可使用绑定的方式赋值

    private string mDisplayMember = "";
    /// <summary>
    /// 获取和设置显示绑定字段。
    /// </summary>
    [Browsable(true), Category("Data"), Description("显示绑定字段"), DefaultValue("")]
    public string DisplayMember  get  return mDisplayMember;  set  mDisplayMember = value;  

     .......

   [Browsable(false), DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
    public object BindDisplayValue
    
        get
        
            return Value;
        
        set
        
            if (value != null)
            
                this.Value = decimal.Parse(value.ToString());
            
        
    

完成

这样一个大致的Numeric的样式与功能有已实现完毕，重新生成项目即可在工具箱中找到它了。

知识拓展

控件中还可以添加事件，当达到某些条件时触发。
以Numeric中为例添加值改变时发生的事件。

    /// <summary>
    /// 值改变时发生
    /// </summary>
    [Description("值改变时发生")]
    public event EventHandler ValueChanged;

并且在Value值改动时使用该事件。

 if (ValueChanged != null) ValueChanged.Invoke(this, new EventArgs());

后言

Smobiler的复杂控件既丰富Smobiler的控件，又可让用户根据自己的需要定制自己的控件提高了UI的多样性，丰富用户使用场景，其高可用又大大节约了用户的开发时间。