在Winform系统界面中对进展阶段的动态展示和处理

在我们做客户关系管理系统的Winform界面的时候，需要对进展阶段这个属性进行一个方便的动态切换和标记处理，如我们根据不同的进展阶段显示不同的相关信息，也可以随时保存当前的阶段信息。其实也是一个比较常见的功能，我们可以把字典列表扁平化动态展示在控件上，然后根据用户选择的阶段位置进行切换即可，本篇随笔就是在客户的需求基础上完善这个功能。

1、进展阶段的动态展示和处理

我们来看看界面的大致情况

其实这部分是根据字典列表进行动态展示的，也就是使用一个用户控件进行处理即可。

为了实现这个功能，我们先创建一个用户控件，如下界面所示，保留一个按钮，这个我们让它先占着位置，最后还是把它追加到最后的位置上即可。

为了展示所有阶段，并记录当前阶段，我们设置了两个变量，放在用户控件里面

        /// <summary>
        /// 阶段列表
        /// </summary>
        public List<CListItem> StageList { get; set; }
        /// <summary>
        /// 当前阶段的值
        /// </summary>
        public double CurrentStage { get; set; }

然后为了在切换和保存两个事件触发外部处理，我们添加两个事件处理，如下所示

        /// <summary>
        /// 选中某个阶段的处理事件
        /// </summary>
        public EventHandler OnSelectedStageHandler { get; set; }
        /// <summary>
        /// 设置阶段完成的处理事件
        /// </summary>
        public EventHandler OnSetCompleteStage { get; set; }

这样用户控件看起来就像是这样子的代码了。

    /// <summary>
    /// 阶段控件显示
    /// </summary>
    public partial class StageControl : BaseUserControl
    {
        /// <summary>
        /// 阶段列表
        /// </summary>
        public List<CListItem> StageList { get; set; }
        /// <summary>
        /// 当前阶段的值
        /// </summary>
        public double CurrentStage { get; set; }
        /// <summary>
        /// 选中某个阶段的处理事件
        /// </summary>
        public EventHandler OnSelectedStageHandler { get; set; }
        /// <summary>
        /// 设置阶段完成的处理事件
        /// </summary>
        public EventHandler OnSetCompleteStage { get; set; }

为了动态展示控件的信息，我们需要使用一个自定义函数来对控件按钮的位置进行判断并绘制，这样可以根据需要进行相关样式的定义，也可以动态变化阶段的列表内容。

        /// <summary>
        /// 初始化控件
        /// </summary>
        public void Init()
        {
            this.Controls.Clear();//清空界面

            //根据阶段列表数量计算每个选项的大小
            if (StageList != null && StageList.Count > 0)
            {
                var count = StageList.Count;
                //计算每项的宽度、高度
                var width = (this.Width-150) * 0.8 / (count * 1.0);
                var height = this.Height * 0.8;

                //计算间隔位置，默认为0，最大不超过20宽度
                double space = 0;
                if ((count - 1) > 0)
                {
                    space = (this.Width * 0.2) / ((count - 1) * 1.0);
                }
                space = (space > 20) ? 20 : space; //限定最大间隔20

                //根据列表项目，动态构建按钮显示项目
                int i = 0;
                foreach (CListItem item in StageList)
                {
                    double value = Convert.ToDouble(item.Value);
                    SimpleButton button = new SimpleButton();
                    button.Text = value.ToString("P0");//显示百分比
                    button.ToolTip = item.Text;
                    button.Tag = value;
                    button.ButtonStyle = BorderStyles.HotFlat;
                    button.Appearance.Options.UseBackColor = true;
                    //根据所处阶段设置背景色
                    if(CurrentStage >= value)
                    {
                        button.Appearance.BackColor = Color.SkyBlue;
                    }
                    else
                    {
                        button.Appearance.BackColor = Color.Transparent;
                    }

                    //按钮的单击事件，触发对外部的处理
                    button.Click += (s,e)=>
                    {
                        var currentStep = (SimpleButton)s;
                        CurrentStage = Convert.ToDouble(currentStep.Tag);
                        if(OnSelectedStageHandler != null)
                        {
                            OnSelectedStageHandler(s, e);
                        }
                        Init();

                    };
                    //根据计算好的信息，设置按钮大小和位置
                    button.Size = new Size((int)width, (int)height);
                    button.Location = new Point(i * (int)(width + space), 0);
                    this.Controls.Add(button);

                    i++;
                }

                this.btnSetComplete.Location = new Point(this.Width-145, 4);
                this.Controls.Add(btnSetComplete);
            }
        }

如果是要保存状态，也交由事件处理

        /// <summary>
        /// 完成操作，触发外部对状态的保存
        /// </summary>
        private void btnSetComplete_Click(object sender, EventArgs e)
        {
            if(OnSetCompleteStage != null)
            {
                OnSetCompleteStage(sender, e);
            }
        }

2、外部窗体使用自定义控件

创建好用户控件后，在外部窗体使用这个用户控件的时候，我们把它拖到窗体界面里面，如下设计界面效果所示。

在这个窗体里面，初始化控件的事件处理，用来做选择的变化处理和保存状态处理。

            this.stageControl1.OnSelectedStageHandler += (s, e) =>
            {
                this.txtStage.SetComboBoxItem(string.Concat(this.stageControl1.CurrentStage));
            };
            this.stageControl1.OnSetCompleteStage += (s, e) =>
            {
                if (!string.IsNullOrEmpty(ID))
                {
                    this.txtStage.SetComboBoxItem(string.Concat(this.stageControl1.CurrentStage));
                    var result = CallerFactory<ISaleChanceService>.Instance.UpdateStage(tempInfo.ID, this.stageControl1.CurrentStage);
                    ShowMessageAutoHide(result.Success ? "设置成功" : "设置失败");
                    ProcessDataSaved(null, null);
                }
            };

我们在调用窗体使用这个进展阶段的控件的时候，需要给它初始化数据，如下是对字典信息的绑定给它。

        /// <summary>
        /// 初始化数据字典
        /// </summary>
        private void InitDictItem()
        {
            //初始化代码
            this.txtStatus.BindDictItems("机会状态");
            this.txtSource.BindDictItems("机会来源");
            this.txtChanceType.BindDictItems("机会类别");

            this.txtCompetitiveIndex.BindDictItems("机会竞争指数");
            this.txtConfidenceIndex.BindDictItems("机会信心指数");
            this.txtStage.BindDictItems("机会进展阶段");

            var listItem = DictItemUtil.GetDictByDictType("机会进展阶段");
            this.stageControl1.StageList = listItem;
        }   

然后在界面显示的时候，调用Init函数即可，如下代码所示。

            //初始化显示控件
            this.stageControl1.Init();

实际项目运行的整体效果如下所示。