DataGridView右鍵菜單自定義顯示及隱藏列

    WinForm程序中表單的列可自定義顯示及隱藏，是一種常見的功能，對於用戶體驗來講是很是好的。筆者通過一段時間的摸索，終於實現了本身想要的功能及效果，現記錄一下過程：

    一、新建一個自定義控件，命名爲：PopupMenuControl。

    二、在PopupMenuControl.Designet文件中的InitializeComponent()方法下面，註冊如下事件：

    this.Paint += new System.Windows.Forms.PaintEventHandler(this.PopupMenuControl_Paint);
    this.MouseDown += new System.Windows.Forms.MouseEventHandler(this.PopupMenuControl_MouseDown);
    this.MouseMove += new System.Windows.Forms.MouseEventHandler(this.PopupMenuControl_MouseMove);

    三、PopupMenuControl的代碼：

    public partial class PopupMenuControl : UserControl
    {
        public delegate void CheckedChanged(int hitIndex, bool isChecked);  //勾選改變委託
        public event CheckedChanged CheckedChangedEvent;                    //勾選改變事件
        PopupMenuHelper popupMenuHelper = null;                             //菜單幫助類，主要負責菜單繪製。

        public PopupMenuControl()
        {
            InitializeComponent();
        }

        public void Initialize(DataGridView dgvTarget)
        {
            //菜單幫助類實例化
            popupMenuHelper = new PopupMenuHelper();
            //將列標題添加到items
            foreach (DataGridViewColumn column in dgvTarget.Columns)
            {
                popupMenuHelper.AddItem(column.HeaderText, column.Visible);
            }
            //菜單繪製
            popupMenuHelper.Prepare(CreateGraphics());
            Width = popupMenuHelper.Width;
            Height = popupMenuHelper.Height;
        }

        /// <summary>
        /// 繪製
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void PopupMenuControl_Paint(object sender, PaintEventArgs e)
        {
            popupMenuHelper.Draw(e.Graphics);
        }

        /// <summary>
        /// 鼠標移過
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void PopupMenuControl_MouseMove(object sender, MouseEventArgs e)
        {
            if (popupMenuHelper.IsMouseMove(e.X, e.Y))
            {
                popupMenuHelper.Draw(CreateGraphics());
            }
        }

        /// <summary>
        /// 鼠標按下
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void PopupMenuControl_MouseDown(object sender, MouseEventArgs e)
        {
            if (popupMenuHelper.IsMouseDown(e.X, e.Y))
            {
                int hitIndex = popupMenuHelper.HitIndex;
                if (hitIndex != -1)
                {
                    bool isChecked = popupMenuHelper.IsCheckedChange(hitIndex, CreateGraphics());
                    OnCheckedChanged(hitIndex, isChecked);
                }
            }
        }

        /// <summary>
        /// 勾選改變
        /// </summary>
        /// <param name="iIndex"></param>
        /// <param name="bChecked"></param>
        public virtual void OnCheckedChanged(int hitIndex, bool isChecked)
        {
            CheckedChangedEvent?.Invoke(hitIndex, isChecked);
        }
    }

    四、這上面涉及到一個PopupMenuHelper的幫助類，此幫助類主要是爲PopupMenuControl控件實現菜單繪製的功能，其代碼以下：

    class PopupMenuHelper
    {
        //變量
        private PopupMenuItem hotItem = null;                           //當前Item
        private List<PopupMenuItem> items = new List<PopupMenuItem>();  //Item集合
        private Bitmap bitmap;                                          //位圖
        private Graphics graphics;                                      //圖像
        private static readonly int BasicConst = 24;                    //Item：高度、Image寬度、2倍Checkbox邊長
        private static readonly int BasicGap = 3;                       //四周間距
        private static readonly int BasicRows = 3;                      //最大行數
        private static readonly int BasicSide = 10;                     //Item：CheckBox邊長(建議用偶數)
        private int totality = 1;                                       //分割總數
        private int[] eachWidth = null;                                 //各個寬度

        //屬性
        public int Width { get { return bitmap.Width; } }               //寬度
        public int Height { get { return bitmap.Height; } }             //高度

        //PopupMenuItem類
        private class PopupMenuItem
        {
            //屬性
            public string ItemText { get; set; }                        //Item文本
            public bool IsChecked { get; set; }                         //勾選狀態

            //構造函數
            public PopupMenuItem(string itemText) : this(itemText, false)
            {
            }
            public PopupMenuItem(string itemText, bool isChecked)
            {
                ItemText = itemText;
                IsChecked = isChecked;
            }
        }

        //無參構造函數
        public PopupMenuHelper()
        {
        }

        /// <summary>
        /// 被點擊Item的Index
        /// </summary>
        public int HitIndex
        {
            get
            {
                return items.IndexOf(hotItem);
            }
        }

        /// <summary>
        /// 勾選改變狀態
        /// </summary>
        /// <param name="hitIndex">被點擊Item的Index</param>
        /// <param name="g">圖像</param>
        /// <returns></returns>
        public bool IsCheckedChange(int hitIndex, Graphics g)
        {
            items[hitIndex].IsChecked = !items[hitIndex].IsChecked;
            Draw(g);
            return items[hitIndex].IsChecked;
        }

        /// <summary>
        /// 添加Item
        /// </summary>
        /// <param name="itemText">Item文本</param>
        /// <param name="isChecked">Item勾選狀態</param>
        public void AddItem(string itemText, bool isChecked)
        {
            items.Add(new PopupMenuItem(itemText, isChecked));
        }

        /// <summary>
        /// 繪製菜單準備
        /// </summary>
        /// <param name="g">圖像</param>
        public void Prepare(Graphics g)
        {
            //獲取菜單的寬度及高度
            totality = (int)Math.Ceiling((double)items.Count / BasicRows);
            eachWidth = new int[totality];
            int totalWidth = 0, totalHeight = 0;
            double maxTextWidth = 0;
            if (totality == 1)
            {
                totalHeight = items.Count * BasicConst + 2 * BasicGap;
                foreach (PopupMenuItem item in items)
                {
                    //SizeF：存儲有序浮點數對，一般爲矩形的寬度和高度。
                    SizeF sizeF = g.MeasureString(item.ItemText, SystemInformation.MenuFont);
                    maxTextWidth = Math.Max(maxTextWidth, sizeF.Width);
                }
                totalWidth = (int)Math.Ceiling((double)maxTextWidth) + BasicConst + 2 * BasicGap;
                eachWidth[0] = (int)Math.Ceiling((double)maxTextWidth) + BasicConst;
            }
            else
            {
                totalHeight = BasicRows * BasicConst + 2 * BasicGap;
                int rows = 0, cols = 1;
                foreach (PopupMenuItem item in items)
                {
                    rows++;
                    //SizeF：存儲有序浮點數對，一般爲矩形的寬度和高度。
                    SizeF sizeF = g.MeasureString(item.ItemText, SystemInformation.MenuFont);
                    maxTextWidth = Math.Max(maxTextWidth, sizeF.Width);
                    if (cols < totality)
                    {
                        //1..[totality-1]列
                        if (rows == BasicRows)
                        {
                            totalWidth += (int)Math.Ceiling((double)maxTextWidth) + BasicConst;
                            eachWidth[cols - 1] = (int)Math.Ceiling((double)maxTextWidth) + BasicConst;
                            maxTextWidth = 0;
                            cols++;
                            rows = 0;
                        }
                    }
                    else
                    {
                        //totality列
                        if ((cols - 1) * BasicRows + rows == items.Count)
                        {
                            totalWidth += (int)Math.Ceiling((double)maxTextWidth) + BasicConst + 2 * BasicGap;
                            eachWidth[cols - 1] = (int)Math.Ceiling((double)maxTextWidth) + BasicConst;
                        }
                    }
                }
            }
            //圖像初始化
            bitmap = new Bitmap(totalWidth, totalHeight);
            graphics = Graphics.FromImage(bitmap);
        }

        /// <summary>
        /// 繪製菜單
        /// </summary>
        /// <param name="g"></param>
        public void Draw(Graphics g)
        {
            Rectangle area = new Rectangle(0, 0, bitmap.Width, bitmap.Height);
            graphics.Clear(SystemColors.Menu);
            DrawBackground(graphics, area);
            DrawItems(graphics);
            g.DrawImage(bitmap, area, area, GraphicsUnit.Pixel);
        }

        /// <summary>
        /// 繪製菜單背景
        /// </summary>
        /// <param name="g"></param>
        /// <param name="area"></param>
        private void DrawBackground(Graphics g, Rectangle area)
        {
            //描邊
            using (Pen borderPen = new Pen(Color.FromArgb(112, 112, 112)))
                g.DrawRectangle(borderPen, area);

            //Image及Text
            int left = BasicGap, top = BasicGap;
            if (totality == 1)
            {
                Rectangle imageArea = new Rectangle(left, top, BasicConst, items.Count * BasicConst);
                using (Brush backBrush = new SolidBrush(Color.FromArgb(240, 240, 240)))
                    g.FillRectangle(backBrush, imageArea);

                Rectangle textArea = new Rectangle(left + BasicConst, top, eachWidth[0], items.Count * BasicConst);
                using (Brush backBrush = new SolidBrush(Color.FromArgb(255, 255, 255)))
                    g.FillRectangle(backBrush, textArea);
            }
            else
            {
                for (int i = 0; i < totality; i++)
                {
                    Rectangle imageArea = new Rectangle(left, top, BasicConst, BasicRows * BasicConst);
                    using (Brush backBrush = new SolidBrush(Color.FromArgb(240, 240, 240)))
                        g.FillRectangle(backBrush, imageArea);

                    Rectangle textArea = new Rectangle(left + BasicConst, top, eachWidth[i], BasicRows * BasicConst);
                    using (Brush backBrush = new SolidBrush(Color.FromArgb(255, 255, 255)))
                        g.FillRectangle(backBrush, textArea);

                    left += eachWidth[i];
                }
            }
        }

        /// <summary>
        /// 繪製全部菜單Item
        /// </summary>
        /// <param name="g">圖像</param>
        private void DrawItems(Graphics g)
        {
            int left = BasicGap, top = BasicGap;
            int rows = 0, cols = 1;
            foreach (PopupMenuItem item in items)
            {
                if (totality == 1)
                {
                    DrawSingleItem(g, left, ref top, eachWidth[0], item, item == hotItem);
                }
                else
                {
                    rows++;
                    DrawSingleItem(g, left, ref top, eachWidth[cols - 1], item, item == hotItem);
                    //1..[totality-1]列
                    if (rows % BasicRows == 0)
                    {
                        left += eachWidth[cols - 1];
                        top = BasicGap;
                        cols++;
                        rows = 0;
                    }
                }
            }
        }

        /// <summary>
        /// 繪製單個菜單Item
        /// </summary>
        /// <param name="g">圖像</param>
        /// <param name="top">圖像Top</param>
        /// <param name="item">菜單Item</param>
        /// <param name="isHotItem">是否爲當前菜單Item</param>
        private void DrawSingleItem(Graphics g, int left, ref int top,int width, PopupMenuItem item, bool isHotItem)
        {
            //Item區域
            Rectangle drawRect = new Rectangle(left, top, width, BasicConst);
            top += BasicConst;

            //Text區域
            Rectangle itemTextArea = new Rectangle
                (
                    drawRect.Left + BasicConst,
                    drawRect.Top,
                    drawRect.Width - BasicConst,
                    drawRect.Height
                );

            //背景色及描邊色
            if (isHotItem)
            {
                //HotItem
                Rectangle hotItemArea = new Rectangle(drawRect.Left, drawRect.Top, drawRect.Width, drawRect.Height);
                using (SolidBrush backBrush = new SolidBrush(Color.FromArgb(214, 235, 255)))
                    g.FillRectangle(backBrush, hotItemArea);
                using (Pen borderPen = new Pen(Color.FromArgb(51, 153, 255)))
                    g.DrawRectangle(borderPen, hotItemArea);
            }

            //Text處理
            StringFormat itemTextFormat = new StringFormat();
            //NoClip：容許顯示字形符號的伸出部分和延伸到矩形外的未換行文本。
            //NoWrap：在矩形內設置格式時，禁用自動換行功能。
            itemTextFormat.FormatFlags = StringFormatFlags.NoClip | StringFormatFlags.NoWrap;
            //Near：指定文本靠近佈局對齊。
            itemTextFormat.Alignment = StringAlignment.Near;
            //Center：指定文本在佈局矩形中居中對齊(呃，感受不是很垂直居中，偏上了一些)。
            itemTextFormat.LineAlignment = StringAlignment.Center;
            //Show：顯示熱鍵前綴。
            itemTextFormat.HotkeyPrefix = HotkeyPrefix.Show;

            SolidBrush textBrush = new SolidBrush(SystemColors.MenuText);
            g.DrawString(item.ItemText, SystemInformation.MenuFont, textBrush, itemTextArea, itemTextFormat);

            //Checkbox處理
            if (item.IsChecked)
            {
                int checkBoxGap = (int)((drawRect.Height - BasicSide) / 2);
                int checkBoxLeft = drawRect.Left + checkBoxGap;
                int checkBoxTop = drawRect.Top + checkBoxGap;

                //將checkBoxArea的Top減1，與文本的對齊效果稍微好一些。
                Rectangle checkBoxArea = new Rectangle(checkBoxLeft, checkBoxTop - 1, BasicSide, BasicSide);
                using (Brush checkBoxBrush = new SolidBrush(Color.FromArgb(214, 235, 255)))
                    g.FillRectangle(checkBoxBrush, checkBoxArea);
                using (Pen checkBoxPen = new Pen(Color.FromArgb(51, 153, 255)))
                    g.DrawRectangle(checkBoxPen, checkBoxArea);

                using (Pen checkBoxTick = new Pen(Color.FromArgb(51, 153, 255)))
                {
                    g.DrawLine(checkBoxTick, new Point(checkBoxLeft, checkBoxTop - 1 + (int)(BasicSide / 2)), new Point(checkBoxLeft + (int)(BasicSide / 2), checkBoxTop - 1 + BasicSide));
                    g.DrawLine(checkBoxTick, new Point(checkBoxLeft + (int)(BasicSide / 2), checkBoxTop - 1 + BasicSide), new Point(checkBoxLeft + BasicSide + BasicGap, checkBoxTop - 1 - BasicGap));
                }
            }
        }

        /// <summary>
        /// 點擊測試
        /// </summary>
        /// <param name="X">X座標</param>
        /// <param name="Y">Y座標</param>
        /// <returns></returns>
        private PopupMenuItem HitTest(int X, int Y)
        {
            if (X < 0 || X > Width || Y < 0 || Y > Height)
            {
                return null;
            }

            int left = BasicGap, top = BasicGap;
            int rows = 0, cols = 1;
            foreach (PopupMenuItem item in items)
            {
                if (totality == 1)
                {
                    rows++;
                    if (X > left && X < left + eachWidth[0] && Y > top + (rows - 1) * BasicConst && Y < top + rows * BasicConst)
                    {
                        return item;
                    }
                }
                else
                {
                    rows++;
                    if (X > left && X < left + eachWidth[cols - 1] && Y > top + (rows - 1) * BasicConst && Y < top + rows * BasicConst)
                    {
                        return item;
                    }
                    //1..[totality-1]列
                    if (rows % BasicRows == 0)
                    {
                        left += eachWidth[cols - 1];
                        top = BasicGap;
                        cols++;
                        rows = 0;
                    }
                }
            }
            return null;
        }

        /// <summary>
        /// 是不是鼠標移過
        /// </summary>
        /// <param name="X">X座標</param>
        /// <param name="Y">Y座標</param>
        /// <returns></returns>
        public bool IsMouseMove(int X, int Y)
        {
            PopupMenuItem popupMenuItem = HitTest(X, Y);
            if (popupMenuItem != hotItem)
            {
                hotItem = popupMenuItem;
                return true;
            }
            else
            {
                return false;
            }
        }

        /// <summary>
        /// 是不是鼠標按下
        /// </summary>
        /// <param name="X">X座標</param>
        /// <param name="Y">Y座標</param>
        /// <returns></returns>
        public bool IsMouseDown(int X, int Y)
        {
            PopupMenuItem popupMenuItem = HitTest(X, Y);
            return popupMenuItem != null;
        }
    }

    這個類實現了多菜單頁面的功能：即若是DataGridView字段很是的多，可經過產生多列菜單來顯示，程序是經過BasicRows變量來控制。

    五、新建一個DataGridViewColumnSelector類，此類的功能主要是銜接DataGridView與PopupMenuControl，其代碼以下：

/// <summary>
    /// DataGridView右鍵菜單自定義顯示及隱藏列
    /// </summary>
    class DataGridViewColumnSelector
    {
        private DataGridView dgvTarget = null;                      //待處理的DataGridView對象
        private ToolStripDropDown dropDown;                         //用於加載PopupMenu控件
        PopupMenuControl popupMenuControl = new PopupMenuControl(); //PopupMenu控件

        //無參構造函數
        public DataGridViewColumnSelector()
        {
            //註冊PopupMenu控件事件
            popupMenuControl.CheckedChangedEvent += new PopupMenuControl.CheckedChanged(OnCheckedChanged);
            //使用容器承載PopupMenu控件(至關於容器類型的ToolStripItem)
            ToolStripControlHost controlHost = new ToolStripControlHost(popupMenuControl);
            controlHost.Padding = Padding.Empty;
            controlHost.Margin = Padding.Empty;
            controlHost.AutoSize = false;
            //加載PopupMenu控件
            dropDown = new ToolStripDropDown();
            dropDown.Padding = Padding.Empty;
            dropDown.AutoClose = true;
            dropDown.Items.Add(controlHost);
        }

        //有參構造函數
        public DataGridViewColumnSelector(DataGridView dataGridView) : this()
        {
            DataGridView = dataGridView;
        }

        //DataGridView屬性
        public DataGridView DataGridView
        {
            get { return dgvTarget; }
            set
            {
                //去除單元格點擊事件
                if (dgvTarget != null) { dgvTarget.CellMouseClick -= new DataGridViewCellMouseEventHandler(DataGridView_CellMouseClick); }
                dgvTarget = value;
                //註冊單元格點擊事件
                if (dgvTarget != null) { dgvTarget.CellMouseClick += new DataGridViewCellMouseEventHandler(DataGridView_CellMouseClick); }
            }
        }

        /// <summary>
        /// 右鍵點擊標題欄彈出菜單
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void DataGridView_CellMouseClick(object sender, DataGridViewCellMouseEventArgs e)
        {
            if (e.Button == MouseButtons.Right && e.RowIndex == -1)
            {
                popupMenuControl.Initialize(dgvTarget);
                //將菜單顯示在光標位置
                dropDown.Show(Cursor.Position);
            }
        }

        /// <summary>
        /// 勾選事件執行方法
        /// </summary>
        /// <param name="hitIndex"></param>
        /// <param name="isCheck"></param>
        private void OnCheckedChanged(int hitIndex, bool isChecked)
        {
            dgvTarget.Columns[hitIndex].Visible = isChecked;
        }
    }

    六、以上這些，已經實現了所有的功能。下面開始建一個WinForm程序來測試結果，爲方便測試將DataGridView的數據源由xml文件讀取。

          從SQL Server數據庫隨便找張數據表生成XML，文件保存爲Test.xml。(請將Test.xml文件拷貝到Debug文件夾下面)

SELECT TOP 10 MO_NO,MRP_NO,QTY,BIL_NO 
FROM MF_MO 
WHERE MO_DD='2019-11-07' 
ORDER BY MO_NO 
FOR XML PATH ('Category'),TYPE,ROOT('DocumentElement')

    七、新建一個WinForm程序，命名爲Main，並拖入一個DataGridView控件，Main_Load方法以下：

        private void Test_Load(object sender, EventArgs e)
        {
            try
            {
                //xml文件路徑
                string path = @"Test.xml";
                //讀取文件
                DataSet ds = new DataSet();
                if (File.Exists(path))
                {
                    ds.ReadXml(path);
                }
                dataGridView1.DataSource = ds.Tables.Count > 0 ? ds.Tables[0] : null;
                //加工dataGridView1
                #region 加列標題測試
                dataGridView1.Columns[0].HeaderText = "制令單號";
                dataGridView1.Columns[1].HeaderText = "成品編號";
                dataGridView1.Columns[2].HeaderText = "生產數量";
                dataGridView1.Columns[3].HeaderText = "來源單號";
                #endregion
                DataGridViewColumnSelector columnSelector = new DataGridViewColumnSelector(dataGridView1);
            }
            catch (Exception ex)
            {
                MessageBox.Show(ex.Message, "提示", MessageBoxButtons.OK, MessageBoxIcon.Information);
            }
        }

    八、執行程序，在任意DataGridView標題欄右擊，便可彈出菜單：

 

    好了，分享就到此結束了，但願對有此須要的人有一些幫助。