LCL_UI -WinForm常用窗体库
文章目录
前言
在做桌面应用程序的开发过程中,发现经常需要做文本输入、选择、判断等操作,每次遇到都在窗体上画控件写事件太过麻烦,于是想到写一套常用到的窗体库,也为以后在遇到节省了时间。
功能列表
项目刚开始,于是我也就需要用到什么就写什么功能,以后遇到的多了慢慢会积累起来的,目前分三部分:
- 窗体
- 提示框
- 消息提示框
- 选择提示框(Yes/No)
- 文本输入框
- 密码输入框
- 列表选择框(多选/单选)
- 消息框
- Toast(仿Android Toast消息框)
- 提示框
- 组件
- 支持窗体跟随鼠标拖拽的组件(具体作用见上一篇文章)
- 控件
- 关闭按钮
快速使用
MsgBox 消息提示框
方法原型
/// <summary>
/// 消息框
/// </summary>
/// <param name="title">标题</param>
/// <param name="content">详细内容</param>
/// <param name="buttonNames">按钮名称</param>
/// <returns></returns>
public static BoxResult<bool> MsgBox(string title, string content = default, string buttonName = null)
示例
DialogBoxes.MsgBox("标题栏", "详细内容写在这里", "知道啦");
PromptBox 选择提示栏
方法原型
/// <summary>
/// 提示框(选择True或False)
/// </summary>
/// <param name="title">标题</param>
/// <param name="content">详细内容</param>
/// <param name="buttonNames">按钮名称</param>
/// <returns></returns>
public static BoxResult<bool> PromptBox(string title, string content = default, string[] buttonNames = null)
示例
// 调用窗体,并在窗体关闭后获取操作结果
var result = DialogBoxes.PromptBox("标题栏", "详细内容写在这里", new string[] { "同意", "残忍拒绝" });
// 这里可以使用MsgBox将结果显示出来(True或False)
DialogBoxes.MsgBox("操作结果", $"你的选择结果是:{result.Data.ToString()}");
InputBox 文本输入框
方法原型
/// <summary>
/// 输入框
/// </summary>
/// <param name="title">标题</param>
/// <param name="content">详细内容</param>
/// <param name="buttonNames">按钮名称</param>
/// <param name="handler">数据格式检查委托</param>
/// <returns></returns>
public static BoxResult<string> InputBox(string title,string content = default,string[] buttonNames = null, InputBox.CheckFormatHandler handler = null)
示例
// 调用窗体,并在窗体关闭后获取操作结果
var result = DialogBoxes.InputBox("标题栏", "详细内容写在这里", null, null);
// 这里可以使用MsgBox将结果显示出来(如果是关闭输入框取消了输入可以另做提示)
if (!result.IsCancel)
{
DialogBoxes.MsgBox(tbTitle.Text, $"刚才输入的内容是:{result.Data}", "好的");
}
else
{
DialogBoxes.MsgBox(tbTitle.Text, "您取消了输入。", "知道啦");
}
PasswordBox 密码输入框
方法原型
/// <summary>
/// 密码框
/// </summary>
/// <param name="title">标题</param>
/// <param name="content">详细内容</param>
/// <param name="buttonNames">按钮名称</param>
/// <param name="handler">数据格式检查委托</param>
/// <returns></returns>
public static BoxResult<string> PasswordBox(string title, string content = default, string[] buttonNames = null, PasswordBox.CheckFormatHandler handler = null)
示例
// 调用窗体,并在窗体关闭后获取操作结果
// 通过传入的lambda表达式检查输入内容格式正确性,如果lambda表达式返回false,则窗体震动。
// 这里的lambda表达式功能是检查密码长度是否达到6位长度
var result = DialogBoxes.PasswordBox(tbTitle.Text, tbContent.Text, new string[] { "确定", "取消", "清除" },(psw) => { return psw.Length >= 6; });
// 这里可以使用MsgBox将结果显示出来(如果是关闭输入框取消了输入可以另做提示)
if (!result.IsCancel)
{
DialogBoxes.MsgBox(tbTitle.Text, $"刚才输入的密码是:{result.Data}", "好的");
}
else
{
DialogBoxes.MsgBox(tbTitle.Text, "您取消了密码输入。", "知道啦");
}
SelectBox 选择列表框
方法原型
/// <summary>
/// 选择框
/// </summary>
/// <param name="title">标题</param>
/// <param name="content">详细内容</param>
/// <param name="items">选项集合</param>
/// <param name="allowMultiSelection">是否可多选</param>
/// <param name="buttonNames">按钮名称</param>
/// <param name="handler">数据格式检查委托</param>
/// <returns></returns>
public static BoxResult<List<string>> SelectBox(string title, string content = default, ICollection items = null,bool allowMultiSelection = false, string[] buttonNames = null, SelectBox.CheckFormatHandler handler = null)
单选模式
示例
// 调用窗体,并在窗体关闭后获取操作结果
// 通过传入的lambda表达式检查输入内容格式正确性,如果lambda表达式返回false,则窗体震动。
// 这里的lambda表达式功能是检查是否至少选择了一项
var result = DialogBoxes.SelectBox(tbTitle.Text, tbContent.Text, new string[] { "土豆", "洋葱", "西红柿", "玉米" }, false, new string[] { "确定", "取消", "全选", "反选" },(items) => { return items.Count > 0; });
// 这里可以使用MsgBox将结果显示出来
if (!result.IsCancel)
{
DialogBoxes.MsgBox(tbTitle.Text, $"刚才勾选的项目是:{result.Data[0]}", "好的");
}
else
{
DialogBoxes.MsgBox(tbTitle.Text, "您取消了选择。", "知道啦");
}
多选模式
方法原型
/// <summary>
/// 选择框
/// </summary>
/// <param name="title">标题</param>
/// <param name="content">详细内容</param>
/// <param name="items">选项集合</param>
/// <param name="allowMultiSelection">是否可多选</param>
/// <param name="buttonNames">按钮名称</param>
/// <param name="handler">数据格式检查委托</param>
/// <returns></returns>
public static BoxResult<List<string>> SelectBox(string title, string content = default, ICollection items = null,bool allowMultiSelection = false, string[] buttonNames = null, SelectBox.CheckFormatHandler handler = null)
示例
// 调用窗体,并在窗体关闭后获取操作结果
var result = DialogBoxes.SelectBox(tbTitle.Text, tbContent.Text,new string[] { "土豆","洋葱","西红柿","玉米"},true,new string[]{ "确定","取消","全选","反选"}, null);
// 这里可以使用MsgBox将结果显示出来
if (!result.IsCancel)
{
StringBuilder sb = new StringBuilder();
foreach (string s in result.Data) sb.Append(s+" ");
DialogBoxes.MsgBox(tbTitle.Text, $"刚才勾选的项目是:{sb}", "好的");
}
else
{
DialogBoxes.MsgBox(tbTitle.Text, "您取消了选择。", "知道啦");
}
Toast 消息提示框
方法原型
/// <summary>
/// 显示消息提示
/// </summary>
/// <param name="content">消息内容</param>
/// <param name="delay">消息提示时长</param>
/// <param name="context">当前处于焦点的控件</param>
public static void Show(string content,int delay = 2000, Control context = null)
示例
// 调用窗体,并在窗体关闭后获取操作结果
Toast.Show("Toast中的信息", 2000, this);
获取Demo程序&DLL文件&源码
下载 DLL&Demo程序: https://github.com/landriesnidis/LCL_UI/releases/latest
源代码 Github: https://github.com/landriesnidis/LCL_UI