前提
入行已经7,8年了,一直想做一套漂亮点的自定义控件,于是就有了本系列文章。
官网:https://www.hzhcontrols.cn
GitHub:https://github.com/kwwwvagaa/NetWinformControl
如果觉得写的还行,请点个 star 支持一下吧
来都来了,点个【推荐】再走吧,谢谢
NuGet
Install-Package HZH_Controls
目录
c#Winform自定义控件-目录_c#winform自定义控件-有图标的按钮-CSDN博客
用处及效果
以上为demo效果,你使用此控件可以实现以下弹出效果
准备工作
没什么准备的
开始
添加一个类NavigationMenuItemExt 继承NavigationMenuItemBase
1 public class NavigationMenuItemExt : NavigationMenuItemBase 2 { 3 public System.Windows.Forms.Control ShowControl { get; set; } 4 }
添加一个用户控件UCNavigationMenuExt
添加属性
1 /// <summary> 2 /// Occurs when [click itemed]. 3 /// </summary> 4 [Description("点击节点事件"), Category("自定义")] 5 6 public event EventHandler ClickItemed; 7 /// <summary> 8 /// The select item 9 /// </summary> 10 private NavigationMenuItemExt selectItem = null; 11 12 /// <summary> 13 /// Gets the select item. 14 /// </summary> 15 /// <value>The select item.</value> 16 [Description("选中的节点"), Category("自定义")] 17 public NavigationMenuItemExt SelectItem 18 { 19 get { return selectItem; } 20 private set { selectItem = value; } 21 } 22 23 /// <summary> 24 /// The items 25 /// </summary> 26 NavigationMenuItemExt[] items; 27 28 /// <summary> 29 /// Gets or sets the items. 30 /// </summary> 31 /// <value>The items.</value> 32 [Description("节点列表"), Category("自定义")] 33 public NavigationMenuItemExt[] Items 34 { 35 get { return items; } 36 set 37 { 38 items = value; 39 ReloadMenu(); 40 } 41 } 42 /// <summary> 43 /// The tip color 44 /// </summary> 45 private Color tipColor = Color.FromArgb(255, 87, 34); 46 47 /// <summary> 48 /// Gets or sets the color of the tip. 49 /// </summary> 50 /// <value>The color of the tip.</value> 51 [Description("角标颜色"), Category("自定义")] 52 public Color TipColor 53 { 54 get { return tipColor; } 55 set { tipColor = value; } 56 } 57 58 /// <summary> 59 /// 获取或设置控件的前景色。 60 /// </summary> 61 /// <value>The color of the fore.</value> 62 /// <PermissionSet> 63 /// <IPermission class="System.Security.Permissions.FileIOPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" /> 64 /// </PermissionSet> 65 public override System.Drawing.Color ForeColor 66 { 67 get 68 { 69 return base.ForeColor; 70 } 71 set 72 { 73 base.ForeColor = value; 74 foreach (Control c in this.Controls) 75 { 76 c.ForeColor = value; 77 } 78 } 79 } 80 /// <summary> 81 /// 获取或设置控件显示的文字的字体。 82 /// </summary> 83 /// <value>The font.</value> 84 /// <PermissionSet> 85 /// <IPermission class="System.Security.Permissions.EnvironmentPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" /> 86 /// <IPermission class="System.Security.Permissions.FileIOPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" /> 87 /// <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" /> 88 /// <IPermission class="System.Diagnostics.PerformanceCounterPermission, System, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" /> 89 /// </PermissionSet> 90 public override Font Font 91 { 92 get 93 { 94 return base.Font; 95 } 96 set 97 { 98 base.Font = value; 99 foreach (Control c in this.Controls) 100 { 101 c.Font = value; 102 } 103 } 104 } 105 106 /// <summary> 107 /// The m LST anchors 108 /// </summary> 109 Dictionary<NavigationMenuItemExt, FrmAnchor> m_lstAnchors = new Dictionary<NavigationMenuItemExt, FrmAnchor>();
加载和绘图
1 private void ReloadMenu() 2 { 3 try 4 { 5 ControlHelper.FreezeControl(this, true); 6 this.Controls.Clear(); 7 if (items != null && items.Length > 0) 8 { 9 foreach (var item in items) 10 { 11 var menu = (NavigationMenuItemExt)item; 12 Label lbl = new Label(); 13 lbl.AutoSize = false; 14 lbl.TextAlign = ContentAlignment.MiddleCenter; 15 lbl.Width = menu.ItemWidth; 16 lbl.Text = menu.Text; 17 18 lbl.Font = Font; 19 lbl.ForeColor = ForeColor; 20 21 lbl.Paint += lbl_Paint; 22 lbl.MouseEnter += lbl_MouseEnter; 23 lbl.Tag = menu; 24 lbl.Click += lbl_Click; 25 if (menu.AnchorRight) 26 { 27 lbl.Dock = DockStyle.Right; 28 } 29 else 30 { 31 lbl.Dock = DockStyle.Left; 32 } 33 this.Controls.Add(lbl); 34 35 lbl.BringToFront(); 36 } 37 38 39 } 40 } 41 finally 42 { 43 ControlHelper.FreezeControl(this, false); 44 } 45 } 46 47 /// <summary> 48 /// Handles the Click event of the lbl control. 49 /// </summary> 50 /// <param name="sender">The source of the event.</param> 51 /// <param name="e">The <see cref="EventArgs"/> instance containing the event data.</param> 52 void lbl_Click(object sender, EventArgs e) 53 { 54 Label lbl = sender as Label; 55 if (lbl.Tag != null) 56 { 57 var menu = (NavigationMenuItemExt)lbl.Tag; 58 if (menu.ShowControl == null) 59 { 60 selectItem = menu; 61 62 while (m_lstAnchors.Count > 0) 63 { 64 try 65 { 66 foreach (var item in m_lstAnchors) 67 { 68 item.Value.Hide(); 69 } 70 } 71 catch { } 72 } 73 74 if (ClickItemed != null) 75 { 76 ClickItemed(this, e); 77 } 78 } 79 } 80 } 81 /// <summary> 82 /// Handles the MouseEnter event of the lbl control. 83 /// </summary> 84 /// <param name="sender">The source of the event.</param> 85 /// <param name="e">The <see cref="EventArgs" /> instance containing the event data.</param> 86 void lbl_MouseEnter(object sender, EventArgs e) 87 { 88 Label lbl = sender as Label; 89 var menu = lbl.Tag as NavigationMenuItemExt; 90 foreach (var item in m_lstAnchors) 91 { 92 m_lstAnchors[item.Key].Hide(); 93 } 94 if (menu.ShowControl != null) 95 { 96 if (!m_lstAnchors.ContainsKey(menu)) 97 { 98 m_lstAnchors[menu] = new FrmAnchor(lbl, menu.ShowControl); 99 } 100 m_lstAnchors[menu].Show(); 101 m_lstAnchors[menu].Size = menu.ShowControl.Size; 102 } 103 } 104 /// <summary> 105 /// Handles the Paint event of the lbl control. 106 /// </summary> 107 /// <param name="sender">The source of the event.</param> 108 /// <param name="e">The <see cref="PaintEventArgs" /> instance containing the event data.</param> 109 void lbl_Paint(object sender, PaintEventArgs e) 110 { 111 Label lbl = sender as Label; 112 if (lbl.Tag != null) 113 { 114 var menu = (NavigationMenuItemExt)lbl.Tag; 115 e.Graphics.SetGDIHigh(); 116 117 if (menu.ShowTip) 118 { 119 if (!string.IsNullOrEmpty(menu.TipText)) 120 { 121 var rect = new Rectangle(lbl.Width - 25, lbl.Height / 2 - 10, 20, 20); 122 var path = rect.CreateRoundedRectanglePath(5); 123 e.Graphics.FillPath(new SolidBrush(tipColor), path); 124 e.Graphics.DrawString(menu.TipText, new Font("微软雅黑", 8f), new SolidBrush(Color.White), rect, new StringFormat() { Alignment = StringAlignment.Center, LineAlignment = StringAlignment.Center }); 125 } 126 else 127 { 128 e.Graphics.FillEllipse(new SolidBrush(tipColor), new Rectangle(lbl.Width - 20, lbl.Height / 2 - 10, 10, 10)); 129 } 130 } 131 if (menu.Icon != null) 132 { 133 e.Graphics.DrawImage(menu.Icon, new Rectangle(1, (lbl.Height - 25) / 2, 25, 25), 0, 0, menu.Icon.Width, menu.Icon.Height, GraphicsUnit.Pixel); 134 } 135 } 136 }
全部代码
// ***********************************************************************
// Assembly : HZH_Controls
// Created : 2019-10-11
//
// ***********************************************************************
// <copyright file="UCNavigationMenuExt.cs">
// Copyright by Huang Zhenghui(黄正辉) All, QQ group:568015492 QQ:623128629 Email:623128629@qq.com
// </copyright>
//
// Blog: https://www.cnblogs.com/bfyx
// GitHub:https://github.com/kwwwvagaa/NetWinformControl
// gitee:https://gitee.com/kwwwvagaa/net_winform_custom_control.git
//
// If you use this code, please keep this note.
// ***********************************************************************
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;
using HZH_Controls.Forms;
namespace HZH_Controls.Controls
{
/// <summary>
/// Class UCNavigationMenuExt.
/// Implements the <see cref="System.Windows.Forms.UserControl" />
/// </summary>
/// <seealso cref="System.Windows.Forms.UserControl" />
[DefaultEvent("ClickItemed")]
public partial class UCNavigationMenuExt : UserControl
{
/// <summary>
/// Occurs when [click itemed].
/// </summary>
[Description("点击节点事件"), Category("自定义")]
public event EventHandler ClickItemed;
/// <summary>
/// The select item
/// </summary>
private NavigationMenuItemExt selectItem = null;
/// <summary>
/// Gets the select item.
/// </summary>
/// <value>The select item.</value>
[Description("选中的节点"), Category("自定义")]
public NavigationMenuItemExt SelectItem
{
get { return selectItem; }
private set { selectItem = value; }
}
/// <summary>
/// The items
/// </summary>
NavigationMenuItemExt[] items;
/// <summary>
/// Gets or sets the items.
/// </summary>
/// <value>The items.</value>
[Description("节点列表"), Category("自定义")]
public NavigationMenuItemExt[] Items
{
get { return items; }
set
{
items = value;
ReloadMenu();
}
}
/// <summary>
/// The tip color
/// </summary>
private Color tipColor = Color.FromArgb(255, 87, 34);
/// <summary>
/// Gets or sets the color of the tip.
/// </summary>
/// <value>The color of the tip.</value>
[Description("角标颜色"), Category("自定义")]
public Color TipColor
{
get { return tipColor; }
set { tipColor = value; }
}
/// <summary>
/// 获取或设置控件的前景色。
/// </summary>
/// <value>The color of the fore.</value>
/// <PermissionSet>
/// <IPermission class="System.Security.Permissions.FileIOPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
/// </PermissionSet>
public override System.Drawing.Color ForeColor
{
get
{
return base.ForeColor;
}
set
{
base.ForeColor = value;
foreach (Control c in this.Controls)
{
c.ForeColor = value;
}
}
}
/// <summary>
/// 获取或设置控件显示的文字的字体。
/// </summary>
/// <value>The font.</value>
/// <PermissionSet>
/// <IPermission class="System.Security.Permissions.EnvironmentPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
/// <IPermission class="System.Security.Permissions.FileIOPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
/// <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" />
/// <IPermission class="System.Diagnostics.PerformanceCounterPermission, System, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
/// </PermissionSet>
public override Font Font
{
get
{
return base.Font;
}
set
{
base.Font = value;
foreach (Control c in this.Controls)
{
c.Font = value;
}
}
}
/// <summary>
/// The m LST anchors
/// </summary>
Dictionary<NavigationMenuItemExt, FrmAnchor> m_lstAnchors = new Dictionary<NavigationMenuItemExt, FrmAnchor>();
/// <summary>
/// Initializes a new instance of the <see cref="UCNavigationMenuExt"/> class.
/// </summary>
public UCNavigationMenuExt()
{
InitializeComponent();
items = new NavigationMenuItemExt[0];
if (ControlHelper.IsDesignMode())
{
items = new NavigationMenuItemExt[4];
for (int i = 0; i < 4; i++)
{
items[i] = new NavigationMenuItemExt()
{
Text = "菜单" + (i + 1),
AnchorRight = i >= 2
};
}
}
}
/// <summary>
/// Reloads the menu.
/// </summary>
private void ReloadMenu()
{
try
{
ControlHelper.FreezeControl(this, true);
this.Controls.Clear();
if (items != null && items.Length > 0)
{
foreach (var item in items)
{
var menu = (NavigationMenuItemExt)item;
Label lbl = new Label();
lbl.AutoSize = false;
lbl.TextAlign = ContentAlignment.MiddleCenter;
lbl.Width = menu.ItemWidth;
lbl.Text = menu.Text;
lbl.Font = Font;
lbl.ForeColor = ForeColor;
lbl.Paint += lbl_Paint;
lbl.MouseEnter += lbl_MouseEnter;
lbl.Tag = menu;
lbl.Click += lbl_Click;
if (menu.AnchorRight)
{
lbl.Dock = DockStyle.Right;
}
else
{
lbl.Dock = DockStyle.Left;
}
this.Controls.Add(lbl);
lbl.BringToFront();
}
}
}
finally
{
ControlHelper.FreezeControl(this, false);
}
}
/// <summary>
/// Handles the Click event of the lbl control.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The <see cref="EventArgs"/> instance containing the event data.</param>
void lbl_Click(object sender, EventArgs e)
{
Label lbl = sender as Label;
if (lbl.Tag != null)
{
var menu = (NavigationMenuItemExt)lbl.Tag;
if (menu.ShowControl == null)
{
selectItem = menu;
while (m_lstAnchors.Count > 0)
{
try
{
foreach (var item in m_lstAnchors)
{
item.Value.Hide();
}
}
catch { }
}
if (ClickItemed != null)
{
ClickItemed(this, e);
}
}
}
}
/// <summary>
/// Handles the MouseEnter event of the lbl control.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The <see cref="EventArgs" /> instance containing the event data.</param>
void lbl_MouseEnter(object sender, EventArgs e)
{
Label lbl = sender as Label;
var menu = lbl.Tag as NavigationMenuItemExt;
foreach (var item in m_lstAnchors)
{
m_lstAnchors[item.Key].Hide();
}
if (menu.ShowControl != null)
{
if (!m_lstAnchors.ContainsKey(menu))
{
m_lstAnchors[menu] = new FrmAnchor(lbl, menu.ShowControl);
}
m_lstAnchors[menu].Show();
m_lstAnchors[menu].Size = menu.ShowControl.Size;
}
}
/// <summary>
/// Handles the Paint event of the lbl control.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The <see cref="PaintEventArgs" /> instance containing the event data.</param>
void lbl_Paint(object sender, PaintEventArgs e)
{
Label lbl = sender as Label;
if (lbl.Tag != null)
{
var menu = (NavigationMenuItemExt)lbl.Tag;
e.Graphics.SetGDIHigh();
if (menu.ShowTip)
{
if (!string.IsNullOrEmpty(menu.TipText))
{
var rect = new Rectangle(lbl.Width - 25, lbl.Height / 2 - 10, 20, 20);
var path = rect.CreateRoundedRectanglePath(5);
e.Graphics.FillPath(new SolidBrush(tipColor), path);
e.Graphics.DrawString(menu.TipText, new Font("微软雅黑", 8f), new SolidBrush(Color.White), rect, new StringFormat() { Alignment = StringAlignment.Center, LineAlignment = StringAlignment.Center });
}
else
{
e.Graphics.FillEllipse(new SolidBrush(tipColor), new Rectangle(lbl.Width - 20, lbl.Height / 2 - 10, 10, 10));
}
}
if (menu.Icon != null)
{
e.Graphics.DrawImage(menu.Icon, new Rectangle(1, (lbl.Height - 25) / 2, 25, 25), 0, 0, menu.Icon.Width, menu.Icon.Height, GraphicsUnit.Pixel);
}
}
}
}
}