搜索

（十）c#Winform自定义控件-横向列表

proginn468312

共 4608字，需浏览 10分钟

 ·

2020-08-07 00:32

准备工作

梳理一下需求，我们需要一个横向的节点列表控件，可以进行左右翻页

根据上面所写的需求，我们需要分为2步操作，1：创建项控件，2：创建列表控件

开始

首先我们创建项控件，添加一个用户控件，命名UCHorizontalListItem

代码量并不多，我们看下完整代码

// 版权所有  黄正辉  交流群：568015492   QQ：623128629
// 文件名称：UCHorizontalListItem.cs
// 创建日期：2019-08-15 16:01:13
// 功能描述：HorizontalList
// 项目地址：https://gitee.com/kwwwvagaa/net_winform_custom_control
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Drawing;
using System.Data;
using System.Linq;
using System.Text;
using System.Windows.Forms;

namespace HZH_Controls.Controls
{
    [ToolboxItem(false)]
    public partial class UCHorizontalListItem : UserControl
    {
        public event EventHandler SelectedItem;
        private KeyValuePair<string, string> _DataSource = new KeyValuePair<string, string>();
        public KeyValuePair<string, string> DataSource
        {
            get { return _DataSource; }
            set
            {
                _DataSource = value;
                int intWidth = ControlHelper.GetStringWidth(value.Value, lblTitle.CreateGraphics(), lblTitle.Font);
                if (intWidth < 50)
                    intWidth = 50;
                this.Width = intWidth + 20;
                lblTitle.Text = value.Value;
                SetSelect(false);
            }
        }
        public UCHorizontalListItem()
        {
            InitializeComponent();
            this.Dock = DockStyle.Right;
            this.MouseDown += Item_MouseDown;
            this.lblTitle.MouseDown += Item_MouseDown;
            this.ucSplitLine_H1.MouseDown += Item_MouseDown;
        }

        void Item_MouseDown(object sender, MouseEventArgs e)
        {
            if (SelectedItem != null)
                SelectedItem(this, e);
        }

        public void SetSelect(bool bln)
        {
            if (bln)
            {
                lblTitle.ForeColor = Color.FromArgb(255, 77, 59);
                ucSplitLine_H1.Visible = true;
                this.lblTitle.Padding = new Padding(0, 0, 0, 5);
            }
            else
            {
                lblTitle.ForeColor = Color.FromArgb(64, 64, 64);
                ucSplitLine_H1.Visible = false;
                this.lblTitle.Padding = new Padding(0, 0, 0, 0);
            }
        }
    }
}
namespace HZH_Controls.Controls
{
    partial class UCHorizontalListItem
    {
        ///  
        /// 必需的设计器变量。
        /// 
        private System.ComponentModel.IContainer components = null;

        ///  
        /// 清理所有正在使用的资源。
        /// 
        /// 如果应释放托管资源，为 true；否则为 false。
        protected override void Dispose(bool disposing)
        {
            if (disposing && (components != null))
            {
                components.Dispose();
            }
            base.Dispose(disposing);
        }

        #region 组件设计器生成的代码

        ///  
        /// 设计器支持所需的方法 - 不要
        /// 使用代码编辑器修改此方法的内容。
        /// 
        private void InitializeComponent()
        {
            this.lblTitle = new System.Windows.Forms.Label();
            this.ucSplitLine_H1 = new HZH_Controls.Controls.UCSplitLine_H();
            this.SuspendLayout();
            // 
            // lblTitle
            // 
            this.lblTitle.Dock = System.Windows.Forms.DockStyle.Fill;
            this.lblTitle.Font = new System.Drawing.Font("微软雅黑", 10F);
            this.lblTitle.ForeColor = System.Drawing.Color.FromArgb(((int)(((byte)(64)))), ((int)(((byte)(64)))), ((int)(((byte)(64)))));
            this.lblTitle.Location = new System.Drawing.Point(1, 0);
            this.lblTitle.Name = "lblTitle";
            this.lblTitle.Padding = new System.Windows.Forms.Padding(0, 0, 0, 10);
            this.lblTitle.Size = new System.Drawing.Size(118, 50);
            this.lblTitle.TabIndex = 1;
            this.lblTitle.Text = "分类名称rn分类名称";
            this.lblTitle.TextAlign = System.Drawing.ContentAlignment.MiddleCenter;
            // 
            // ucSplitLine_H1
            // 
            this.ucSplitLine_H1.BackColor = System.Drawing.Color.FromArgb(((int)(((byte)(255)))), ((int)(((byte)(77)))), ((int)(((byte)(59)))));
            this.ucSplitLine_H1.Dock = System.Windows.Forms.DockStyle.Bottom;
            this.ucSplitLine_H1.Location = new System.Drawing.Point(1, 50);
            this.ucSplitLine_H1.Name = "ucSplitLine_H1";
            this.ucSplitLine_H1.Size = new System.Drawing.Size(118, 3);
            this.ucSplitLine_H1.TabIndex = 0;
            this.ucSplitLine_H1.TabStop = false;
            // 
            // UCHorizontalListItem
            // 
            this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.None;
            this.Controls.Add(this.lblTitle);
            this.Controls.Add(this.ucSplitLine_H1);
            this.Name = "UCHorizontalListItem";
            this.Padding = new System.Windows.Forms.Padding(1, 0, 1, 0);
            this.Size = new System.Drawing.Size(120, 53);
            this.ResumeLayout(false);

        }

        #endregion

        private UCSplitLine_H ucSplitLine_H1;
        private System.Windows.Forms.Label lblTitle;
    }
}

设计效果如图

接着我们来创建列表控件，添加一个用户控件，命名UCHorizontalList

我们看下需要提供哪些属性

public UCHorizontalListItem SelectedItem { get; set; }
public event EventHandler SelectedItemEvent;
private int m_startItemIndex = 0;
private bool isAutoSelectFirst = true;

public bool IsAutoSelectFirst
{
    get { return isAutoSelectFirst; }
    set { isAutoSelectFirst = value; }
}

private Liststring, string>> dataSource = null;

public Liststring, string>> DataSource
{
    get { return dataSource; }
    set
    {
        dataSource = value;
        ReloadSource();
    }
}

我们有时需要刷新列表

public void ReloadSource()
{
    try
    {
        ControlHelper.FreezeControl(this, true);
        this.panList.SuspendLayout();
        this.panList.Controls.Clear();
        this.panList.Width = this.panMain.Width;
        if (DataSource != null)
        {
            foreach (var item in DataSource)
            {
                UCHorizontalListItem uc = new UCHorizontalListItem();
                uc.DataSource = item;
                uc.SelectedItem += uc_SelectItem;
                this.panList.Controls.Add(uc);
            }
        }
        this.panList.ResumeLayout(true);
        if (this.panList.Controls.Count > 0)
            this.panList.Width = panMain.Width + this.panList.Controls[0].Location.X * -1;
        this.panList.Location = new Point(0, 0);
        m_startItemIndex = 0;
        if (this.panList.Width > panMain.Width)
            panRight.Visible = true;
        else
            panRight.Visible = false;
        panLeft.Visible = false;
        panList.SendToBack();
        panRight.SendToBack();
        if (isAutoSelectFirst && DataSource != null && DataSource.Count > 0)
        {
            SelectItem((UCHorizontalListItem)this.panList.Controls[0]);
        }
    }
    finally
    {
        ControlHelper.FreezeControl(this, false);
    }
}

还需要处理选中处理

private void SelectItem(UCHorizontalListItem item)
{
    if (SelectedItem != null && !SelectedItem.IsDisposed)
        SelectedItem.SetSelect(false);
    SelectedItem = item;
    SelectedItem.SetSelect(true);
    if (SelectedItemEvent != null)
        SelectedItemEvent(item, null);
}private void SelectItem(UCHorizontalListItem item)
{
    if (SelectedItem != null && !SelectedItem.IsDisposed)
        SelectedItem.SetSelect(false);
    SelectedItem = item;
    SelectedItem.SetSelect(true);
    if (SelectedItemEvent != null)
        SelectedItemEvent(item, null);
}

然后就是翻页功能的处理了

private void panLeft_MouseDown(object sender, MouseEventArgs e)
{
   if (this.panList.Location.X >= 0)
   {
       this.panList.Location = new Point(0, 0);
       return;
   }

   for (int i = m_startItemIndex; i >= 0; i--)
   {
       if (this.panList.Controls[i].Location.X < this.panList.Controls[m_startItemIndex].Location.X - panMain.Width)
       {
           m_startItemIndex = i + 1;
           break; ;
       }
       if (i == 0)
       {
           m_startItemIndex = 0;
       }
   }

   ResetListLocation();
   panRight.Visible = true;
   if (this.panList.Location.X >= 0)
   {
       panLeft.Visible = false;
   }
   else
   {
       panLeft.Visible = true;
   }
   panList.SendToBack();
   panRight.SendToBack();
}

private void panRight_MouseDown(object sender, MouseEventArgs e)
{
   if (this.panList.Location.X + this.panList.Width <= this.panMain.Width)
       return;
   if (this.panList.Controls.Count <= 0)
       return;
   for (int i = m_startItemIndex; i < this.panList.Controls.Count; i++)
   {
       if (this.panList.Location.X + this.panList.Controls[i].Location.X + this.panList.Controls[i].Width > panMain.Width)
       {
           m_startItemIndex = i;
           break;
       }
   }
   ResetListLocation();
   panLeft.Visible = true;
   if (panList.Width + panList.Location.X <= panMain.Width)
       panRight.Visible = false;
   else
       panRight.Visible = true;
   panList.SendToBack();
   panRight.SendToBack();
}

private void ResetListLocation()
{
   if (this.panList.Controls.Count > 0)
   {
       this.panList.Location = new Point(this.panList.Controls[m_startItemIndex].Location.X * -1, 0);
   }
}

最后向外暴露一个设置选中的功能

public void SetSelect(string strKey)
{
  foreach (UCHorizontalListItem item in this.panList.Controls)
  {
      if (item.DataSource.Key == strKey)
      {
          SelectItem(item);
          return;
      }
  }
}

以上就是主要东西了，再看下完整代码

// 版权所有  黄正辉  交流群：568015492   QQ：623128629
// 文件名称：UCHorizontalList.cs
// 创建日期：2019-08-15 16:01:06
// 功能描述：HorizontalList
// 项目地址：https://gitee.com/kwwwvagaa/net_winform_custom_control
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Drawing;
using System.Data;
using System.Linq;
using System.Text;
using System.Windows.Forms;

namespace HZH_Controls.Controls
{
    public partial class UCHorizontalList : UserControl
    {
        public UCHorizontalListItem SelectedItem { get; set; }
        public event EventHandler SelectedItemEvent;
        private int m_startItemIndex = 0;
        private bool isAutoSelectFirst = true;

        public bool IsAutoSelectFirst
        {
            get { return isAutoSelectFirst; }
            set { isAutoSelectFirst = value; }
        }

        private Liststring, string>> dataSource = null;

        public Liststring, string>> DataSource
        {
            get { return dataSource; }
            set
            {
                dataSource = value;
                ReloadSource();
            }
        }

        public UCHorizontalList()
        {
            InitializeComponent();
        }

        public void ReloadSource()
        {
            try
            {
                ControlHelper.FreezeControl(this, true);
                this.panList.SuspendLayout();
                this.panList.Controls.Clear();
                this.panList.Width = this.panMain.Width;
                if (DataSource != null)
                {
                    foreach (var item in DataSource)
                    {
                        UCHorizontalListItem uc = new UCHorizontalListItem();
                        uc.DataSource = item;
                        uc.SelectedItem += uc_SelectItem;
                        this.panList.Controls.Add(uc);
                    }
                }
                this.panList.ResumeLayout(true);
                if (this.panList.Controls.Count > 0)
                    this.panList.Width = panMain.Width + this.panList.Controls[0].Location.X * -1;
                this.panList.Location = new Point(0, 0);
                m_startItemIndex = 0;
                if (this.panList.Width > panMain.Width)
                    panRight.Visible = true;
                else
                    panRight.Visible = false;
                panLeft.Visible = false;
                panList.SendToBack();
                panRight.SendToBack();
                if (isAutoSelectFirst && DataSource != null && DataSource.Count > 0)
                {
                    SelectItem((UCHorizontalListItem)this.panList.Controls[0]);
                }
            }
            finally
            {
                ControlHelper.FreezeControl(this, false);
            }
        }

        void uc_SelectItem(object sender, EventArgs e)
        {
            SelectItem(sender as UCHorizontalListItem);
        }

        private void SelectItem(UCHorizontalListItem item)
        {
            if (SelectedItem != null && !SelectedItem.IsDisposed)
                SelectedItem.SetSelect(false);
            SelectedItem = item;
            SelectedItem.SetSelect(true);
            if (SelectedItemEvent != null)
                SelectedItemEvent(item, null);
        }

        private void panLeft_MouseDown(object sender, MouseEventArgs e)
        {
            if (this.panList.Location.X >= 0)
            {
                this.panList.Location = new Point(0, 0);
                return;
            }

            for (int i = m_startItemIndex; i >= 0; i--)
            {
                if (this.panList.Controls[i].Location.X < this.panList.Controls[m_startItemIndex].Location.X - panMain.Width)
                {
                    m_startItemIndex = i + 1;
                    break; ;
                }
                if (i == 0)
                {
                    m_startItemIndex = 0;
                }
            }

            ResetListLocation();
            panRight.Visible = true;
            if (this.panList.Location.X >= 0)
            {
                panLeft.Visible = false;
            }
            else
            {
                panLeft.Visible = true;
            }
            panList.SendToBack();
            panRight.SendToBack();
        }

        private void panRight_MouseDown(object sender, MouseEventArgs e)
        {
            if (this.panList.Location.X + this.panList.Width <= this.panMain.Width)
                return;
            if (this.panList.Controls.Count <= 0)
                return;
            for (int i = m_startItemIndex; i < this.panList.Controls.Count; i++)
            {
                if (this.panList.Location.X + this.panList.Controls[i].Location.X + this.panList.Controls[i].Width > panMain.Width)
                {
                    m_startItemIndex = i;
                    break;
                }
            }
            ResetListLocation();
            panLeft.Visible = true;
            if (panList.Width + panList.Location.X <= panMain.Width)
                panRight.Visible = false;
            else
                panRight.Visible = true;
            panList.SendToBack();
            panRight.SendToBack();
        }

        private void ResetListLocation()
        {
            if (this.panList.Controls.Count > 0)
            {
                this.panList.Location = new Point(this.panList.Controls[m_startItemIndex].Location.X * -1, 0);
            }
        }

        public void SetSelect(string strKey)
        {
            foreach (UCHorizontalListItem item in this.panList.Controls)
            {
                if (item.DataSource.Key == strKey)
                {
                    SelectItem(item);
                    return;
                }
            }
        }
    }
}
namespace HZH_Controls.Controls
{
    partial class UCHorizontalList
    {
        ///  
        /// 必需的设计器变量。
        /// 
        private System.ComponentModel.IContainer components = null;

        ///  
        /// 清理所有正在使用的资源。
        /// 
        /// 如果应释放托管资源，为 true；否则为 false。
        protected override void Dispose(bool disposing)
        {
            if (disposing && (components != null))
            {
                components.Dispose();
            }
            base.Dispose(disposing);
        }

        #region 组件设计器生成的代码

        ///  
        /// 设计器支持所需的方法 - 不要
        /// 使用代码编辑器修改此方法的内容。
        /// 
        private void InitializeComponent()
        {
            this.panMain = new System.Windows.Forms.Panel();
            this.panList = new System.Windows.Forms.Panel();
            this.panRight = new System.Windows.Forms.Panel();
            this.panLeft = new System.Windows.Forms.Panel();
            this.panMain.SuspendLayout();
            this.SuspendLayout();
            // 
            // panMain
            // 
            this.panMain.Controls.Add(this.panList);
            this.panMain.Dock = System.Windows.Forms.DockStyle.Fill;
            this.panMain.Location = new System.Drawing.Point(46, 0);
            this.panMain.Name = "panMain";
            this.panMain.Size = new System.Drawing.Size(422, 53);
            this.panMain.TabIndex = 3;
            // 
            // panList
            // 
            this.panList.Anchor = System.Windows.Forms.AnchorStyles.Left;
            this.panList.BackColor = System.Drawing.Color.Transparent;
            this.panList.Location = new System.Drawing.Point(0, 0);
            this.panList.Name = "panList";
            this.panList.Size = new System.Drawing.Size(401, 53);
            this.panList.TabIndex = 0;
            // 
            // panRight
            // 
            this.panRight.BackgroundImage = global::HZH_Controls.Properties.Resources.chevron_right;
            this.panRight.BackgroundImageLayout = System.Windows.Forms.ImageLayout.Center;
            this.panRight.Dock = System.Windows.Forms.DockStyle.Right;
            this.panRight.Location = new System.Drawing.Point(468, 0);
            this.panRight.Name = "panRight";
            this.panRight.Size = new System.Drawing.Size(46, 53);
            this.panRight.TabIndex = 2;
            this.panRight.Visible = false;
            this.panRight.MouseDown += new System.Windows.Forms.MouseEventHandler(this.panRight_MouseDown);
            // 
            // panLeft
            // 
            this.panLeft.BackgroundImage = global::HZH_Controls.Properties.Resources.chevron_left;
            this.panLeft.BackgroundImageLayout = System.Windows.Forms.ImageLayout.Center;
            this.panLeft.Dock = System.Windows.Forms.DockStyle.Left;
            this.panLeft.Location = new System.Drawing.Point(0, 0);
            this.panLeft.Name = "panLeft";
            this.panLeft.Size = new System.Drawing.Size(46, 53);
            this.panLeft.TabIndex = 1;
            this.panLeft.Visible = false;
            this.panLeft.MouseDown += new System.Windows.Forms.MouseEventHandler(this.panLeft_MouseDown);
            // 
            // UCHorizontalList
            // 
            this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.None;
            this.Controls.Add(this.panMain);
            this.Controls.Add(this.panRight);
            this.Controls.Add(this.panLeft);
            this.Name = "UCHorizontalList";
            this.Size = new System.Drawing.Size(514, 53);
            this.panMain.ResumeLayout(false);
            this.ResumeLayout(false);

        }

        #endregion

        private System.Windows.Forms.Panel panLeft;
        private System.Windows.Forms.Panel panRight;
        private System.Windows.Forms.Panel panMain;
        private System.Windows.Forms.Panel panList;
    }
}

用处及效果

用处：一般用着需要横向切换选项的地方，比如省份切换等

效果：

调用示例 

Liststring, string>> lstHL = new Liststring, string>>();
for (int i = 0; i < 30; i++)
{
    lstHL.Add(new KeyValuePair<string, string>(i.ToString(), "选项" + i));
}

this.ucHorizontalList1.DataSource = lstHL;

最后的话

如果你喜欢的话，请到 https://gitee.com/kwwwvagaa/net_winform_custom_control 点个星星吧，另本站转载地址：https://dotnet9.com/5323.html。

  • 作者：冰封一夏
  • 出处：http://www.hzhcontrols.com/doc.html
  • 本文版权归作者所有，欢迎转载，但未经作者同意必须保留此段声明， 且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。
  • GitHub：https://github.com/kwwwvagaa/NetWinformControl
  • 码云：https://gitee.com/kwwwvagaa/net_winform_custom_control.git


浏览 63
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报
评论
图片
表情
推荐
（一）C#Winform自定义控件-基类控件
proginn468312
0
（十一）C# Winform自定义控件-列表
proginn468312
0
ZUUIRevealControlleriOS 横向切换控件
ZUUIRevealController 是一个类似Facebook 客户端的视图横向切换的效果。
ZUUIRevealControlleriOS 横向切换控件
ZUUIRevealController 是一个类似 Facebook 客户端的视图横向切换的效果。
MAActionCelliOS 列表控件
MAActionCell旨在用于MATableViewSection对象，大大简化和整合所有静态UITableViews创建的逻辑和处理数据资源和委托逻辑。数据和委托资源函数没有太多的if和switc
BAMEasyTableiOS 列表控件
BAMEasyTable 是一个类让你方便的构建一个 UITableView，只需要提供一个数组或者
TableKit.miOS 列表控件
TableKit.m可以让你轻松创建具有“块”语法的列表视图。
ELHeaderViewios列表控件
实现类似网易新闻订阅中的HeaderView。滑动列表时，列表的HeaderView中的图片产生视差滚动效果（Parallax），并且文字会放大或者缩小，比一般的视差滚动效果更好。[Code4App.
BAMEasyTableiOS 列表控件
BAMEasyTable是一个类让你方便的构建一个UITableView，只需要提供一个数组或者一组数组即可，可方便添加、删除以及重新排序列表中的条目。
MAActionCelliOS 列表控件
MAActionCell 旨在用于 MATableViewSection 对象，大大简化和整合所有静
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报