ApeForms | Dialog组件
@[toc]
前言
ApeForms一款基于WinForm实现的开源免费商用的UI库,其中提供了一套便于用户交互的临时对话框组件(Dialog),可用于快速创建开发中常见的交互对话框,例如:消息框、提示框、输入框、单选框、多选框等。
ApeFree.ApeDialogs并不是一个包含Dialog实现的UI库,而是一套Dialog标准(提供了一套临时弹出对话框的实现标准)。 Dialog是界面开发过程中必不可少的组件,无论是桌面开发、Web前端开发、移动端开发,甚至命令行应用程序中的一次“Yes or No”的输入都可以看做是一次Dialog弹框。
示例
准备步骤
如下所示,创建Dialog提供器:
ApeFormsDialogProvider provider = DialogFactory.Factory.GetApeFormsDialogProvider();
消息对话框 MessageDialog
var dialog = provider.CreateMessageDialog(s =>
{
// 是否可取消
s.Cancelable = true;
// 修改确认键文本
s.ConfirmOption.Text = "知道了";
// 修改Dialog窗体尺寸
s.DialogSize = new Size(400, 250);
// 修改标题名
s.Title = tbTitle.Text;
// 修改文本内容
s.Content = tbContent.Text;
});
dialog.Show();
输入对话框 InputDialog
var dialog = provider.CreateInputDialog(s =>
{
// 标题文本
s.Title = tbTitle.Text;
// 消息文本
s.Content = tbContent.Text;
// 输入框默认文本
s.DefaultText = "You can set the default text in the input box by using the 'DefaultText' property.";
// 是否可取消
s.Cancelable = true;
// 是否允许输入为空
s.AllowEmpty = false;
// 输入文本最大长度
s.MaximumLength = 200;
// 输入文本最小长度
s.MinimumLength = 6;
// 是否多行
s.IsMultiline = false;
// 确认按钮文本
s.ConfirmOption.Text = "Confirm(确定)";
// 取消按钮文本
s.CancelOption.Text = "Cancel(取消)";
// 清空按钮文本
s.ClearOption.Text = "Clear(清空)";
});
dialog.Show();
if (dialog.Result.IsCancel)
{
Toast.Show("取消输入");
}
else
{
Toast.Show($"输入内容为:{dialog.Result.Data}");
}
多行输入对话框 MultiLineDialog
var dialog = provider.CreateInputDialog(s =>
{
// 标题文本
s.Title = tbTitle.Text;
// 消息文本
s.Content = tbContent.Text;
// 输入框默认文本
s.DefaultText = "You can set the default text in the input box by using the 'DefaultText' property.";
// 是否可取消
s.Cancelable = true;
// 是否允许输入为空
s.AllowEmpty = false;
// 输入文本最大长度
s.MaximumLength = 200;
// 输入文本最小长度
s.MinimumLength = 6;
// 是否多行
s.IsMultiline = true;
// 确认按钮文本
s.ConfirmOption.Text = "Confirm(确定)";
// 取消按钮文本
s.CancelOption.Text = "Cancel(取消)";
// 清空按钮文本
s.ClearOption.Text = "Clear(清空)";
});
dialog.Show();
if (dialog.Result.IsCancel)
{
Toast.Show("取消输入");
}
else
{
Toast.Show($"输入内容为:{dialog.Result.Data}");
}
密码输入对话框PasswordDialog
var dialog = provider.CreatePasswordDialog(s =>
{
s.Title = tbTitle.Text;
s.Content = tbContent.Text + $"\r\n提示:密码至少要[6]位";
s.PasswordChar = '●';
s.PrecheckResult = password => password != null && password.Length >= 6;
});
dialog.Show();
if (dialog.Result.IsCancel)
{
Toast.Show("取消输入");
}
else
{
Toast.Show($"输入密码为:{dialog.Result.Data}");
}
提示对话框 PromptDialog
var dialog = provider.CreatePromptDialog(s =>
{
// 标题文本
s.Title = tbTitle.Text;
// 消息文本
s.Content = tbContent.Text;
// 积极选项文本
s.PositiveOption.Text = "Yes";
// 消极选项文本
s.NegativeOption.Text = "No";
}, null);
dialog.Show();
if (dialog.Result.Data)
{
Toast.Show("结果:积极选项");
}
else
{
Toast.Show("结果:消极选项");
}
单选对话框 SelectionDialog
var dialog = provider.CreateSelectionDialog(students, null, s =>
{
// 标题文本
s.Title = tbTitle.Text;
// 消息文本
s.Content = tbContent.Text;
// 设置预检查回调
s.PrecheckResult = item =>
{
var b = item != null;
if (!b)
{
Toast.Show("至少要选一项哦!", 2000, null, ToastMode.Reuse);
}
return b;
};
s.ItemDisplayTextConvertCallback = stu => $"{stu.Name} ({stu.Description})";
});
dialog.Show();
if (dialog.Result.IsCancel)
{
Toast.Show("取消选择");
}
else
{
Toast.Show($"结果:{dialog.Result.Data.Name} , {dialog.Result.Data.Description}");
}
示例类型及数据:
class Student
{
public Student(string name, string description)
{
Name = name;
Description = description;
}
public string Name {
get; set; }
public string Description {
get; set; }
}
Student[] students = new Student[] {
new Student("张三","一年级"),
new Student("李四","三年级"),
new Student("王二","五年级"),
new Student("马六","五年级"),
};
多选对话框 MultipleSelectionDialog
var dialog = provider.CreateMultipleSelectionDialog(students, null, s =>
{
// 标题文本
s.Title = tbTitle.Text;
// 消息文本
s.Content = tbContent.Text;
// 设置预检查回调
s.PrecheckResult = item =>
{
var b = item.Any();
if (!b)
{
Toast.Show("至少要选一项哦!", 2000, null, ToastMode.Reuse);
}
return b;
};
s.ItemDisplayTextConvertCallback = stu => $"{stu.Name} ({stu.Description})";
});
dialog.Show();
if (dialog.Result.IsCancel)
{
Toast.Show("取消选择");
}
else
{
Toast.Show({
mathJaxContainer[0]}"{s.Name}({s.Description})"))}");
}
示例数据与单选对话框 SelectionDialog
示例数据一致。
UI库安装与使用
请参考文章:《ApeForms | WinForm窗体UI美化库(Metro扁平风格)演示与安装》
获取示例源码
ApeForms UI库源码地址:https://github.com/ApeFree/ApeFree.ApeForms
ApeForms Demo源码地址:https://github.com/ApeFree/ApeFree.ApeForms.Demo
下载体验Demo.exe网盘链接:https://landriesnidis.lanzouy.com/b011mr7rg 密码:26fx